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This publication will aid you — as a 
sjstBm programmer — to extend and modify 
tiie IBM Time Sharing System. Available 
programming facilities and necessary coding 
conirentlons are described. Examples are 
provided to give yon an understanding of 
what is involved in changing the system. 

Part 1 contains both orientation and 
how-to information and is divided into: 

• Section 1: an introduction to system 
programming and system programmer's 
facilities . 

• Seirtion 2: The basic concepts and 
structure of TSS. 

• Section 3: Conventions to use when 
coding routines for TSS, 



SE&DER'S 6DIDE 



Several other TSS publications contain 
information related to system programming 
and monitoring. 



• Concepts and Facilities > GC28-2003, 
presents the basic concepts and 
features of TSS. 



System Generation and Haintenance , 
GC28-2010, describes the procedure for 
creating and maintaining the source and 
object forms of TSS; specifically ^ the 
macro instructions and commands you may 
use to add, delete, or modify system 
object modules. 



• Section 4: Facilities available to 
system programmers; information on how 
they can be used and, in some cases, 
changed. 

• Section 5: How to write macro 
definitions for use in the system. 

Part II provides a reference to macro 
instructions (not described in Assembler 
User Macro Instructions ! available to 
system programmers (and several options 
available only to system programmers) , and 
is divided into: 



Time Sharing Support System , GC28-2006, 
describes the on-line program .error 
analysis system designed specifically 
for system programmers. 



aultiterminal-TasIc Programming and 
Operation, GC28-2034, describes 
multiterminal task programming 
techniques. You should, of course, be 
familiar with other IBM Tine Sharing 
System publications, such as: 



Section 1 : 
described . 



How macro instructions are 



Assembler Programmer's Guide #GC28-2032 



• Section 2: Descriptions of the macro 
instructions , arranged alphabetically . 



Assembler Pser Macro Instructions ^ 
GC23-2004 



Part III discusses commands that are 
available only to the system programmer, or 
that have special options available only to 
the system programmer- 
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PART It SYSTIH PlOgBAHHUG 



This part describes a sfstea prograaaert his funcrtiions, the sfstea 
facdlities available to bis, a&d the systea prograa stmctares and con- 
ventions that he nnst observe vhen coding systea nodnles. 

SECTIOM 1: IMfRODPCTIOH 



fine Sharing System (TSS) is a set of programs. Each prograa per- 
forms a part of the overall job that the system as a whole was designed 
and developed to do. System programmiilg vith TSS involves adding to, 
deleting from, or modifying these programs. 

What a System Programmer Does 

ks a system programmer, yon are expected to be an experienced pro* 
grammer responsible for modifying, extending, and generally adapting TSS 
to snit the needs of yonr installation. To do this, yon should be know- 
ledgeable in two areas: ft) the design and construction of TSS, and f2) 
the needs and capacity of yonr installation. 

Why TSS Is a Modnlar System 

Any large, general-purpose programming system is a compromise of the 
many conflicting demands of its prospective users. System designers 
attempt to construct an efficient programming system that will satisfy 
diverse demands. All situations can never be anticipated. Generality 
must sometimes be sacrificed for efficiency, lealizing this, the deve- 
lopers of TSS have produced a modular system whose parts can be changed. 
The rules, suggestions, and operating considerations for changing the 
system are described in the following pages. 



THE SYSTKH PROSBAHMBB 

A programmer becomes known to TSS as a system programmer when he is 
Joined to the system by the system manager or one of the system adminis- 
trators with a special authority code (0 or P) • 



SfSTSH PR06RAHHB1 AOTHORXTT CODES 

The Jon command contains an authority code which may have the values 
fuser) , P (system programmer) , or O (privileged system programmer) . 
As a system programmer, you will have been given an O or P. then a user 
logs on, information is taken from the user table built by the JOIl com- 
mand processor and inserted into the user's task status index (TSl) and 
interrupt storage area (ISA) . The STC gueue proc^essor controls what 
programs are allowed to issue privileged SVCs; it uses the authority 
code information the ItOGOl processor stores in the task status index at 
field (TSIFI) for this purpose. The dynamic loader and program control 
system use information stored by the LOGOl processor in the interruption 
storage area field (ISAUTH) to determine if the task may perform certain 
privileged operations. 
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PlIVILBGE CLASS 

As a system programmer, you may be Joined to the system with combined 
privilege classes D and E; each class is associated with a particular 
set of facilities available for your use. The system programmer with 
class D and 1 privilege is often referred to, in TSS publications, as 
the system monitor. Authority O or P is not, however, a prerequisite of 
Privilege E. 

fhe assignment of privilege class D (along with your authority code 
of P or O) designates you as a system programmer. This privilege class 
provides you with the facilities described in Assembler User Hacro In- 
structions jand Command System User's Guide : in conjunction with your au- 
thority code, class D also provides you with most of the facilities dis- 
cussed under "System Programming Facilities" in this publication. 

The assignment of privilege class E, which designates you as a system 
monitor, extends the range of facilities available to you. Through cer- 
tain options that only the privilege class E programmer can use in the 
DBEF command and macnro instruction, in the DCB macro instruction, and in 
the SECUBE command, you can reserve specific I/O devices and directly 
utilize unit record equipment. It also provides you with the ability to 
use the Multiple Sequential Access lehtod (HSAH) , denied to ordinary 
users and to system programmers who have not been assigned privilege 
class S. 



BESPOHSIBILITIES OF A SYSTEM PIOGIAMMEE 

System programmers are responsible for generating the specific ver- 
sion of TSS used at each installation and for troubleshooting and main- 
taining that system once it is generated. Maintenance involves analyz- 
ing system problems, designing changes (additions, deletions, etc.) , and 
incorporating IBM-issued changes applicable to the installation. 

System generation 

System generation consists basically of reassembling and replacing 
system modules containing configuration-dependent tables and 
installation-option parameters. System generation macro instructions 
are used to cx>ntrol this operation. These macro instructions, as well 
as the system generation process, are described in System Generation and 
Maintenance > GC28-2010. 

System Maintenance 

lou should not attempt to modify TSS unless you have a thorough 
knowledge of the system's logic, in particular of the interfaces involv- 
ed in each modification. Detailed information about methods of instal- 
ling system modifications can be found in System Generation and 
Maintenance . 



SYSTEM PBOGBAMMIIG FACILITIES 

A brief summary of the facilities available to system programmers is 
presented below. The facilities available to system programmers are 
usually invoked by issuing system-defined macro instructions and com- 
mands. Hacro instructions are described in detail in Part II of this 
publication. Commands are described in detail in Part III. General use 
of these facilities by system programmers is described in Section 1, 
"System Facilities," in Part I of this publication. 



E&CRO IMSTBOCflOMS 

Two groups of macro instrtictioEs are provided in TSS. One group is 
made available to the ordinary aser to aid him in managing his data and 
programs . I second groap is provided for system programmers to aid them 
in the system generation process and in coding system modules* 

System Programmer Eacro Instructions 

Hany different macro instructions are available to a system programm- 
er. He may use: the macro instructions provided tor generating TSS and 
adopting it to an installation's requirements, the macro instructions 
employed within system code, and the macro instructions provided to the 
ordinary user of TSS, as indicated below under ••User Macro Instruc- 
tions*" If he has been joined to the system with both privilege classes 
D and E, he can also employ macro instructions used by the the Rultiple 
Sequential Access Method (MSIIHJ . 

User Macro Instructions ; Macro instructions available to all TSS users 
are described in Assembler User Macro Instructions * 

System Generation Macro Instructions : System generation macro instruc- 
tions perform several basic functions; they inform the software system 
of the hardware configuration of an installation, they establish the 
command system options and defaults, and they assign the task management 
parameters that are used for dispatching and controlling tasks within 
TSS» These task management parameters are used by TSS to manipulate 
virtual storage, control paging operations, and regulate the size and 
number of tasks by type. These macro instructions are described in 
detail in System Generation and Maintenanc e. 

System Macro Instructions : The system macro instructions used in system 
programs and those available for the development of complex installation 
I functions are described in detail in Part II of this publication; macros 
I usable only in real memory are called supervisor macros. 

Restrict ions on Use of System Macro Instructions 

Most system macro instructions generate Supervisor Call instructions 
(SVCs) to establish linkage to a system-provided routine. The dispatch- 
ing of these system routines is controlled by S¥C queue processors. 
System programmers should be aware that use of many of these SVCs is re- 
stricted by the queue processor (and occasionally by the system routine 
that is called) to privileged users having a certain authority code. 
SVCs issued in nonprivileged code generally pass control to system pro- 
grams in privileged virtual storage; those issued in privileged code 
pass control to system programs in main storage. These are generally 
referred to, respectively, as nonprivileged and privileged SVCs* Some 
SfCs can be executed in both nonprivileged and privileged code, k sum- 
mary of the requirements for assembly and execution of particular SVCs 
can be found in Appendix B. 

COMMANDS 

Many ISS commands are available only to system programmers. There 
are also several commands, available to all TSS users, that have partic- 
ular options that are available only to system programmers. These com- 
mands generally require that a system programmer be joined to the system 
with authority code or P, privilege class E, or the userid TSS*****. 
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The comrndLUiks defined for sjstea prograttsers fall into three groups: 
general services ^ servicreabilitj aids, and system monitor facilities. 

General Services 

The general service conaands provide system programmers with m^sage 
maintenance and storage maintenance facilities. Detailed descriptions 
of these commands are included under >*Sf stem Programmer Commands** in 
Part III. 

Serviceability Aids 

The following commands are for monitoring system performance and for 
analyzing sources of system errors. 

• Program Control System (PCSI : I set of commands that enable yon to 
locate problem sources in nonprivileged, virtual storage programs. 
PCS also provides similar, but restricted, facilities for trouble- 
shooting privileged virtual storage programs. (lo PCS facilities 
are available for resident programs.) The use of these facilities 
is discussed briefly in Part I, Section 4. 1 detailed descxiption 
of the facilities can be found in Command System User's Guide . 

• Time Sharing Support System fTSSSI ; k support system that enables 
you to gain access to all storage (real, virtual, and auxiliary) and 
all registers from a terminal. This support incorporates a command 
language which lets you dynamically modify both system and user 
tasks. Like PCS, it is a subsystem within TSS; unlike PCS, it is 
available only to the system programmer. The use of these facili- 
ties is discussed more fully in Part I, Section 4. I detailed de- 
scription of the facilities can be found in Time Sharing Support 
System . 

System Monitor Facilities 

JL special set of command options is available for system programmers 
that have a privilege class of B (system monitor) . These options allow 
the programmer to reserve unit record eguipment for nonconversational 
tasks, refer to devices symbolically, and to print ASCII data sets from 
tape devices. The special operand values of the SECUll, BDIF, and PIIIT 
commands, that provide the class-1 programmer with these capabilities, 
are described in Part I, Section ^, under ■•Ixtended System Monitor 
facilities.* 



SECTIOH 2: SYSTEM PBOgBAMS 



TSS QBGAHIZATIOH 

The prograns that sake up TSS are of two types: resident prograas, 
which are brought into waiB storage and left there until the nachine is 
turned off; and nonresident or virtual storage prograas, which are 
brought into aain storage as required and are reaoTed froa aain storage 
when the space is needed* During the operation of TSS, both kinds of 
prograas inter acrt bj using a well defined interface. This interface is 
described under **Taslcs«* 

lesident prograas schedule the use of the sjstea*s resources* Thej 
aonitor aultiprograaaing and aultiprocessing in TSS. nonresident pro- 
graas provide services to the user, aalcing it easier for hia to use the 
systea. km atteapt has been aade to separate these responsibilities as 
auch as possible. 

HESIDEIT PR06BAHS 

This section discmsses the characteristics of the TSS resident super- 
visor. If you are priaarily interested in scheduling and resource allo- 
cation, you will find this section of special interest. 

6ETTIHG STIBTID 

In TSS, a prograa called Startup brings into aain storage all aodules 
that aake up the resident supervisor. Besident prograas have the saae 
structure as any other TSS object aodules; they have a prograa aodule 
dictionary (PHD) and text. Startup reads the various resident object 
aodules froa a disic pack called the IFI. voluae, resolves the syabolic 
references between the aodules, assigns thea aain storage, and resolves 
address constants cxintained in thea. Startup also initializes prefixed 
storage areas (PS Is) and issues an external start to a second processing 
unit, if one is attached. 

Besident aodules initially contain address constants; however, once 
Startup has transferred control to the resident supervisor, these 
address constants have been resolved and the relocation of resident pro- 
graas is c:oaplete. 

I nuaber of tables, or systea control blocks, are also initialized by 
Startup. These tables enable the resident supervisor to keep tracdt of 
resources. One of these resources is aain storage space, which will be 
reserved for the resident supervisor's use. Space not used for resident 
prograas, or set aside for their use, is available for allocation to 
nonresident prograas. 

HOBHAL OFEBITIOl 

Extended Control PSW 

When Startup transfers control to the resident supervisor, the IBM 
central processing unit is in the extended control aode, the aode that 
supports TSS on the Systea/370 . The foraat of the extended €x>ntrol 
prograa status word (XFSl) is shown in Figure 1 . Because resident pro- 
graas operate unrelocated, bit 5 in the XFSW, the relocation bit, is 
always 0. The protection key is also 0, giving resident prograas access 
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to all main storage, the privilege state bit is 0, toor since resident 
prograns operate in the supervisor state. Any program interrnption in 
the supervisor state is considered an error; to allow detection of pro- 
gran interruptions, the four program mask bits are Is. The second vord 
of the XPSW contains the instruction address in bit positions 10 -63. 
Besident programs are responsible for controlling dynamic relocation of 
non-resident programs; they do not, themselves, run with the address 
translator on. Addresses used by resident programs are always real ad- 
dresses, limited by physical storage. The maximum allowable amount of 
main storage is 16,777,216 bytes (22 ♦) . 
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1 Program Event Recording, disallowed (0) or allowed (IJ , 

subject to Event Hask Bits in Control Register 9 
T Relocation, off (0) or on (1) 
10 I/O interruption mask, disallowed (0) or allowed (1) 

subject to Channel Hask Bits in Control Register 2 
E External interruption mask, disallowed (OJ or allowed (1) 
Key Storage protection key 

L Extended Control Mode, BC Mode (0) or EC Mode (1) 
H Hachine che<^ mask, disallowed (0) or allowed 0} 
1 Wait state, running (0) or waiting (1) 
P Problem state, supervisor (0) or problem (1) 
CC Condition code 
PHSK Program mask 
Mot used Bit positions 0, 2-«l, 16-17, 2^1-31, and 32-39; 

a specification exception is recognized when these bit 

positions do not contain zeros 

Figure 1. Extended control program status word 

The Prefixed Storage Area 

then the multiprocessing feature is installed in a CPU most addresses 
associated with storage reference by the CPU are processed by a 
mechanism called ••prefixing." All addresses subject to this processing 
are referred to as "real" addresses. Storage addresses which are not 
subject to this processing, and all addresses that have been processed, 
whether or not they are changed, are referred to as "absolute" 
addresses . 



As a result of the processing to form the absolute address, real ad- 
dresses 0-4095 are interchanged with the '1, 096 addresses of the block 
that begins at the address identified in the prefix register. All other 
real addresses remain unchanged. 

The real addresses 0-4095 include the addresses of the assigned 
storage locations that are implicitly generated by the CPU and channels, 
and includes the addresses that can be specified by a program without 
the use of a base address or an index. Prefixing provides the ability 
to reassign this block of real locations for each CPU to a different 
block in absolute main storage, thus permitting more than one CPU shar- 



E^ing Bain s-^orage to operate concurrentlj vitb a BiniBUB of inter- 
ference, especially in this processing of interruptions. 

Because the prefixing BechanisB interchanges the real addresses, each 
CPU c:an access all of absolute Bain storage, including the first 4,096 
bytes and the assigned locations for another CPU. 

The relationship between real and absolute addresses is graphically 
depicted in Figure 2. 
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the contents of the register can be set and inspected by the privi- 
leged instructions SET FIEFIX and STOIE FEEFIX^ respectively. On set- 
ting ^ bits corresponding to bit positions 0-7 and 20-31 of the prefix 
register are ignored. On storing^ zeros are provided for these bit 
positions. The prefix register is initialized to zero. 

Prefixing is applied to all references to main storage and to keys in 
storage, except for references by a CPU to the permanently assigned 
storage locations during performance of the store-status function, and 
except for references by a channel to extended-logout locations, to I/O 
data, to indirect -data-address vords, and to CCWs. When dynamic address 
translation is specified, prefixing is applied after the address has 
been translated by the dynamic-address -translation mechanism. When 
installed, prefixing is always active and is not subject to any mode 
control. 

When prefixing is applied, the storage address is translated as 
follows: 

a. Bits 8-19 of the storage address, if all zeros, are replaced with 
bits 8-19 of the prefix. 

b. Bits 8-19 of the storage address, if egual to bits 8-19 of the 
prefix, are replaced with all zeros. 

c. Bits 8-19 of the storage address, if not all zeros and not egual 
to bits 8-19 of the prefix, remain unchanged. 

In all cases, bits 20-31 of the storage address remain unchanged. 

Only the address presented to storage is translated by prefixing, 
fhe contents of the source of the address remain unchanged. 

fhe distinction between real and absolute addresses is made even when 
prefixing is not installed or when the prefix register contains all 
zeros. In both of these cases, a real address and its corresponding 
absolute address are identical. 

The f oi^at of the prefixed storage area can be seen by copying the 
dsect CHAPSJL. 



SUIHARI 

lesident programs make up the part of TSS known as the resident su- 
pervisor. The extended control mode of operation is normal for resident 
programs. These programs, operating in the supervisor state with the 
address translator turned off and with an XPSl protection key of zero, 
can execute any System/370 (including all M158 and M168 multiprocessors) 
instrucrtions and use all main storage except page zero in a dual system. 
Each processing unit also has 16 general-purpose registers, ^ floating- 
point registers, 16 extended-control registers, an interval timer, an 
address translator, and other components for fetching and executing 
instructions . 



WOIHESIDEHT PROGBAIIS 

nonresident, or virtual storage, programs are programs that operate 
with the address translation unit turned on; they do not permanently 
reside in main storage. There are two kinds of virtual storage pro- 
grams: privileged and nonprivileged. For a conceptual understanding of 
virtual storage, see Concepts and Facilities and System Logic Summary . 



TkSK SfUJCTORE 

The nonresident portion of TSS, as well as a user's application pro- 
grams, operate within the context of indiTidnal tasks. To the sjstea 
user, the task is an individual work regnirenent; to the system itself 
(and the resident supervisor in particular) , the task is a unit of acti- 
vity to be allocated system facilities, inclnding a periodic time-slice 
of the CPO. 

A task has a virtual storage whose size is essentially independent of 
the physical main storage available to the resident supervisor. Virtual 
storage is organized into pages of 4096 bytes, which are further 
collected into segments of 16 pages* Virtual storage consists of a max- 
imum of 256 segments (16,777,216 bytes) with 2ft-bit addressing. 

Just as OS subdivides its instruction set into two states, supervisor 
and problem, a task may run with a privileged or a nonprivileged in- 
struction set. The privileged instruction set, somewhat analogous to 
the supervisor state, contains all OS problem state instructions and 
those S?C (Supervisor Call) instructions designated as privileged. The 
nonprivileged instruction set, somewhat analogous to the problem state, 
contains all OS problem state instructions and those SVC instructions 
designated as nonprivileged. 

Each task contains not only any application programs called by the 
user (in the form of object modules) , parts of data sets referred to by 
these programs, and dynamically acquired virtual storage data areas, but 
also those portions of the TSS control program which are nonresident and 
any system facilities specifically requested (such as language proces- 
sors) . But each task does not have to have a separate copy of the non- 
resident system modules (the nonresident TSS control program) ; it shares 
with other tasks the a single copy of nonresident system modules in main 
storage. 



IMITIAL VI1T0IL STOllGE 

The task monitor and a number of programs (both privileged and non- 
privileged) are collected into what is called initial virtual storage or 
initial virtual memory (IVl) • Startup establishes initial virtual 
storage by constructing a standard set of segment and page tables to be 
used by each newly created task. Initial virtual storage programs are 
never dynamically loaded; they are permanently resident in virtual 
storage. Of course, IVH programs are paged in and out of main storage. 
All other privileged programs are brought into virtual storage, as re- 
quired, by the dynamic loader (which must be part of I?i!) . Virtual 
storage is never ••empty*; it always contains at least the programs that 
make up the IVH. 

Virtual Program Status lord 

Each task has 16 general-purpose registers and 4 floating-point regi- 
sters available to it. The status of a task is described by its virtual 
program status word (VPSW) , which is shown in Figure 3. 
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P Privilege. (0) privileged or (1) nonprivileged 

Bits 4-7 are the task mask and are interpreted: 

X External interruptions 

I Isjnclironoiis interruptions 

T tiaer interruptions 

I Synchronous interruptions 

ILC Instruction length code 
CC Condition code 

Bits 12-15 are interpreted: 

FO Fixed point overflow mask 

BO Decimal overflow mask 

EU Exponential overflow mask 

SF Loss of significance mask 

For all of the above masks, one permits an interruption on the 
occurrence of the condition and zero inhibits the interruption. 

Figure 3. Virtual program status word 

Interruption Storage Area 

A task is interrupted by a virtual, or task, interruption. When this 
occurs, the information constituting the current VPSf is stored in a 
predetermined area of virtual storage (depending on the type of inter- 
ruption) , becoming the old VPSl. A new VPSl, obtained from another 
location in that area, becomes the current VPSf. The area, called the 
interruption storage area (ISA) is analogous to the prefixed storage ar- 
ea (PSA) in the system's real main storage. The interruption storage 
area is bytes through 8190 of virtual storage* 

There are eight different virtual, or task, interruptions: program, 
supervisor call, external, asynchronous I/O, task-timer, synchronous I/O 
recoverable data set paging error, and TSS. The occurrence of four of 
these interruptions is controlled by the task mask in the VPSW, analo- 
gous to the system mask in the PSl. If the mask bit corresponding to a 
given interruption type is 0, or if the interruption storage area is 
locked (ISALCK set by the ITI macro instruction) , interruptions for that 
type are saved by the resident supervisor, until the mask bit is set to 
1. 

Each task has an instruction set consisting of all OS problem state 
instructions and a number of supervisor call instructions. The supervi- 
sor call instructions are further divided into SVCs that can be issued 
only by privileged programs, SVCs that can be issued only by privileged 
or nonprivileged programs depending on the authority code of the pro- 
grammer. The privileged SVCs are analogous to OS supervisor state in- 
structions. Each of these SVCs is described in detail later. 

The current VPSl, contained in field ISACVP, includes the address of 
the instrucrtion following the last instruction executed prior to the in- 
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terruption- While the interruption is being serviced or is waiting to 
be serviced, this address is significant in that it points to the in- 
struction at which execution is to be resuned. Once execution is 
resumed, the current VPSi continues to point to the same instruction; 
the address is not incremented as each instruction is executed and, 
therefore, loses its significance. 



StOlAGE PIOTECTIOH 

lit hough the virtual program status word doesn't contain a key, 
storage protection is in effect for virtual programs. The resident su- 
pervisor assigns storage keys to virtual programs when it creates exter- 
nal page table entries for them; it sets keys in the main storage pages 
it allocates (see the ADDPG and IDSPG macro instruction descriptions) . 
Each main storage page is assigned a storage protection key; Figure 4 
illustrates these assignments. 



I Type of Page 

I 



Key 



Fetch Protection Bit 



(Honprivileged read/nrite 

i Ion privileged read-only 

I Privileged 

(Engaged in paging operation 

{Storage obtained from supervisor 

\ core allocation 

I Resident supervisor 



1 

2 
2 
3 
i| 



off 

off 

on 

off 

off 

on 



Figure 4. Hain storage page key assignments 



The ability of a CPO or a data channel to have access to main storage 
is controlled by the protection key contained in storage and the privi- 
lege key used by the CPU (FSW) or data channel (CAW) . The resident su- 
pervisor assigns keys to programs and channel programs before starting 
them; these assignments are shown in Figure 5. 



i" ■ ■ ' ■ ' T ' " 1 

1 Category I Key | 


IProcessincr Unit Proarams 1 1 


1 Honprivileged I 1 | 
1 Privileged | I 
1 lesident supervisor j | 

IData Channel Proarams 1 1 


1 Honprivileged I/O | 1 | 
1 Privileged I/O f 2 | 
1 Paging I/O | 3 | 
1 lOHCB I/O 1 4 1 
1 Sense data I/O | 4 | 

1 » - _ - x - - - 1 



Figure 5. CPU and data channel key assignments 

Figure 6 shows the significance of various combinations of PSW and 
storage keys and the programs to which they may be assigned. Those 
within the heavy line designate nonprivileged user key combinations. 
The other combinations are available only to privileged system programs, 
Storage protect key 2F is the same as key 2 but with fetch protection 
added. 
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Figure 6. PSW and storage protection keys 



PfilflLEGED PBOGfillS 

k privileged program is a virtual prograa recognized by kaving its 
virtual program status word (VPSW) privilege bit (bit 0) set to 0^ ana- 
logons to tlie privileged state bit (bit 15) in the real PSW. I privi- 
leged program differs from a nonprivileged nser program in two principal 
ways: it operates with a PSW protection key of and it may issue most 
Supervisor Call instructions. I privileged program can access all vir- 
tual storage in its own task; it cannot access private virtual storage 
in other tasks. 

Privileged programs exist to provide services to nonprivileged pro- 
grams. Privileged service routines that can be cmlled by users are 
"connected" to the task monitor through a table, called the IITSB table 
(see the IMTBB macro instruction) ; other privileged service routines are 
closed subroutines used only by privileged callers. 

VOWPBITILIGSD PB06BAHS 

1 nonprivileged program operates in a task, fhe storage of this task 
contains all programs that make up IVH and any other programs that have 
been brought into virtual storage by the dynamic loader. I nonprivi- 
leged system program may be part of IfH (the assembler is an example of 
a nonprivileged initial virtual storage program) . 

I nonprivileged program may use any OS problem state instruction and 
any nonprivileged Supervisor Call instruction. Nonprivileged system 
programs may not, in general, use the privileged Supervisor Call in- 
structions. The resident supervisor uses the task status index to de- 
termine whether a program can issue privileged S?Cs. 

Sinc^e a number of SfC codes are used by the resident supervisor, a 
kind of substitute SfC, called IITEB, is used for most transfers of con- 
trol from nonprivileged to privileged programs, k nonprivileged program 
can't transfer control to a privileged program with a branch instruction 
since all privileged programs are fetch protected from all nonprivileged 
programs (both system and user) • BlffBB codes, analogous to S¥C codes, 
are used by the task monitor to determine where to transfer control. 
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fhe progiraBaing coBventioms that system prograamers aust observe when 
coding modules that are to be made a part of the resident or nonresident 
portion of TSS control programs are discussed belov. 

I RESIDENT (SUPER YISOR> PEQGRAMS 

COIfENflOBS FOE NAMIMG OBJECT MODULES 

All TSS programs have standardized object module names r control sec- 
tion names, and entrj point names. When an object module becomes part 
of the system, any reference to it must use the module name, an entry 
point name, or a control section name. fSS object module names consist 
of five characters; those TSS modules that are part of the resident su- 
pervisor have names with the form: 

CElxx 

where xx are alphameric characters that identify the module within the 
resident supervisor. All TSS object module names begin with C; the 
characters SA identify resident supervisor modules. 

All entry point and control section names begin with the module name, 
like this: 

C EAxxn 

where n is a character that identifies the entry point or control sec- 
tion within the object module. Mote that special characters are not 
used in TSS names* 

As an example, the pathfinder module in the resident supervisor has 
the name CEAA5; its entry points are CEAA5P, CEAA5R, and CBAA5S. 

There are other sets of modules that are in the resident part of TSS. 
These components and their naming conventions are: 

Resident RTAM CEDxx 

Resident RSS CEHxx 

Machine check recovery CMAxx 

MODULE DISIGS COISIDERATIOHS 

Assume that you have a change to TSS in mind, and that you clearly 
understand the logic of the change you wish to make. How do you con- 
struct the program? Resident programs are different from nonresident 
programs in one major way: Resident prograiis do not contain prototype 
control sections (PSlCTs) . The purpose of a prototype control section 
is to contain any part of a program that changes during relocation or 
execution. As pointed out previously, resident programs are never relo- 
cated or never change addresses during execution. The address constants 
used by resident programs are resolved during startup; they will not be 
changed after the system is initialized. The only items in the resident 
supervisor that can change are the variables used by resident programs. 
These variables are kept in registers, system control blocks, or working 
storage obtained from the supervisor core (main storage) allocation sub- 
routine. Your program must be designed to use one of these areas for 
holding variable information; which one you use depends on what you are 
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attempting to do- The key test of a resident program's correct con- 
struction is that it be sianltaneoiisly executable by snltiple processing 
units. If the registers are used as working storage, anltiple proces- 
sors nay sinultaneonsly execute the program, since each processor supp- 
lies its own registers. If a systen control block is used, the lock 
byte controls the modification of variable information. If storage ob- 
tained from the supervisor core allocration subroutine is used, each 
allocation of storage is kept separate from the others to ensure the 
protection of variables. 

Module Structure 

Like any other object module, a resident module consists of a program 
module dictionary (PHD) and text. Usually, a resident program contains 
a single read-only, nonprototype control section. I resident program 
may contain address constants to be iromputed and placed into the text by 
Startup. The read-only control sections do not change; they are never 
modified during program execution. 

In addition to read-only control sections, the resident supervisor 
contains tables or system control blocks. I system control block is 
data in main storage, organized in some vay knovn to the programs that 
use it. The system table, CHBSIS, is an example of a system control 
block used by a number of resident programs; it contains such informa- 
tion as parameters used for task migration, limits of task size and num- 
ber, and other values affecrting the overall operation of the system. 

If there is any possibility that one processor can change a system 
control block at the same time another processor is working on it, the 
control block must be protected, or interlocked .^ with a lock byte. A 
lock byte is a single byte used to control access to variable informa- 
tion. The test and set instruction is used to find out whether a lock 
byte is on or off (and also to turn it on) . For example: 

TEST TS lOCK 
BO WAIT 

tests a lock byte called LOCK; if LOCK is all 1»s, control is trans- 
ferred to WAIT. A lock byte is set (or on) if it is all 1*s (actually, 
only the high-order bit is tested) ; it is reset (or off) dLf it is all 
0*s. 

Since the correct locking and unlocking of TSS lock bytes is critical 
to the running of a multi-cpu system, TSS programs ahould use two 
macros, QETLOCK and FIBBLOCK, to perform these functions. These macros 
generate code, provide some tracing data for debugging and generate sys- 
tem errors in a standard way. 

Some programs do not need to test lock bytes, since they are subrou- 
tines of programs that do test. Some cxintrol blocks are not individual- 
ly tested (and do not contain a lock byte) but are gathered into gueues; 
the entire gueue is interlocked instead of its members. 

A lock byte is reset when the program that set it has finished using 
the protected information. In most cases a second processing unit will 
only wait a certain length of time for a lock byte to be reset; if the 
lock byte is not reset within that time period, a minor system error is 
recognized, then control is returned to the point of interruption by 
the error routine, the protected data becomes available. 

In addition to read-only control sections and interlocked system con- 
trol blocks, the resident supervisor contains a number of pages (or a 
■•pool") of main storage that may be used, as reguired, by resident pro- 
grams. The program controlling the use of this storage pool is the su- 
pervisor core allocation module. Since the supervisor core allocation 
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module itself cannot reguire the allocation of storage space to free 
working registers, it sa¥es the registers in a special area in the PSA. 

fielativelf few sfstem control blocks continnomslf reguire main 
storage space; nost have transient storage needs* Resident prograas 
nsuallj obtain storage space for transient data from the supervisor core 
allocation module. Ihen the need for this data no longer exists^ the 
space is returned to the supervisor core release subroutine; this dfnam- 
ic allocation of main storage space ensures that the resident supervisor 
doesn^t tie up more storage space than it actually needs, lost tran- 
sient data areas cannot be used simultaneously by separate processing 
units; these control blocks are not interlocked. 1 few transient data 
areasr however, can be used by separate processing units; these are 
interlocked. 

Some data areas are known only to one processing unit because one of 
its registers points to the data area; other data areas are known to all 
processing units because the address of the data area is kept in common 
main storage. 

Getting Resident Working Space 

Working space is not assembled into resident programs for twc» rea- 
sons: (1) it is inefficient to assemble space that may not be used into 
a program, and (2) the resident program would have to schedule the use 

of that space if the program were to be simultaneously executed by 
separate processing units. 

Resident programs use four modules to obtain working space for their 
execution. These routines are supervisor core (main storage) allocation 
(CEAL01) , supervisor core release (CE1L02) , user core allocation 
(ClAMB) , and user core release (CEII.04) • User main storage is allocated 
from one pool and supervisor main storage from another, but the supervi- 
sor pool may be replenished from the storage released by user core re- 
lease. The supervisor core allocation routine satisfies requests for 
resident working space such as control blocks like the generalized queue 
entry {GQEJ and the task status index (TSI) . The user core allocation 
routine satisfies requests for storage for extended task status indexes 
(XTSI) and for nonresident program pages. 

The supervisor core allocation subroutine is a special program, since 
it has private space in the prefixed storage area (PSI) , which it uses 
to store the contents of the general registers. It must use this area 
since there is no subroutine that it can call to get working space. 
Programs that call the supervisor core allocation subroutine must save 
registers 0, 1, 1^, and 15 before transferring control. They can't do 
this without working space, though, so four words in the prefixed area 
(PSISCU) are set aside for programs calling the supervisor core alloca- 
tion subroutine. This lets a called program immediately become a call- 
ing program without losing the contents of any of the general registers 
that were supplied to it. Since a program calling supervisor core allo- 
cation must use registers 0, 1, 14, and 15 to transfer control (and 
parameters) , it would lose the original crontents of these registers if 
it had no place to save them. I typical use of the supervisor core 
allocation subroutine might look like this: 



Section 3: System Programming Conventions 15 



SOBfi 



HTII 



IDa>ll 



USIIG 


*r15 


COPY 


CHAPSA 


OSING 


CHAPSArO 


CSECT 




STM 


14^1, PS AS CO 


LA 


0^128 


SH 


1,1 


L 


15,AI>C0H 


BASR 


14,15 


LE 


8,1 


1.1 

• 


14,1,PSASC0 


• 
• 
DC 


?(C1AL01) 



IIGISTIR 15 COMTAIHS BASE 

GET THE DSECT 

PSA DSECT MEEDS 10 BASE 

lEESTABLISH CSECT 

SAVE BEGS 0, 1, 14, and 15 II PSA 

IBQOEST 128 BYTES 

OPTIOIS ALL ZBIO 

POIlTEl TO SUPVl COIE ALLOC 

TlAMSFEl COMTEOL 

SA¥B ADDRESS 

EESTOIE SEGS 14, 15, 0, AHD 1 



ADDR SOPfR CORE ALLOCATIOl EODTIIE 



la this exaiple, when supervisor core allocation returns control, 
register 1 points to a 128-byte area of iiain storage that can be used 
for any further transient storage needs this program aay have. The su- 
pervisor core allocation subroutine will not disturb the register con- 
tents saved by this program in PSASCU since supervisor core allocation 
has its own save area in the PSA (PSACAS) . 

To give this space back to the supervisor core release nodule, the 
program night be coded like this: 



DOME 



RTEH 



ADCII2 



STl 


14,1,PSASC1J 


LB 


1,8 


LA 


0,128 


L 


15,ADCN2 


BASE 


14,15 


LH 


14,1, PSASCU 


BE 


14 


DC 


V (CEAL02) 



SAVE BEGS 

ADDBBSS OF SPACE 1E*RB BETOEIIIIG 

GIVE BACK 128 BITES 

POIITBE TO SUPVB CORE EETRM 

TRAISFER COITEOL 

RESTORE REGS 

RETURH TO ORIGIIAL CALLER 

ADDR SUPVR CORE RELEASE 



This will return for reallocation the 128 bytes obtained in the previous 
example. 

Two macros, GETCORE and RELCORB, are used in TSS to standardize and 
simplify these linkages. 

For transient work areas that will not be needed after the module 
returns to the program that called it, e.g., register save areas, mes- 
sage areas, parameters for a subroutine, etc., a macro, GETWORK, is to 
be used. This macro allocates space from a preallocated stack. It uses 
far less instructions than calling supervisor core allocation and the 
space does not have to be released. 

Secondary Entry Points 

Resident modules with more than one entry point are designed so that 
their base register always points to the primary entry point, even if 
control of the modules has been transferred to a secondary entry point. 
Sometimes it's done like this: 
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EQU 


15 




EHTII 1 


USIBS 

• 


*,BISB 




BIT112 


• 
BISB 


BASE,0 






OSXIIG 


*,BISB 






L 


6ISE,IDC01 






OSIIG 

• 


EHtlYl^BISB 




ADCOl 


• 
DC 


l(BllTlll) 


STStea 


Control 


Blocks 





The resident supervisor consists of three parts: read-onlf control 
sections, systea control blocks, and a pool of dynaaically allocatable 
■ain storage • The resident supervisor uses the storage pool to create 
transient system control blocks such as the generalized gnene entry 
(6QE) and the page control block (PCB) . During their "lifetiaes,* tran- 
sient control blocks are resident in main storage. Transient control 
blocks exist only as long as they are needed; this aay be a few millise- 
conds or a f ev minutes* When they are no longer needed, the main 
storage space they occupy is returned for reallocation; they are not 
paged out to auxiliary storage. 

The resident supervisor also creates nonresident system control 
blocks, nonresident system control blocks exist on auxiliary storage 
and are brought into main storage only when needed. They exist on some 
storage device for a relatively long time, for example, for an entire 
terminal session. Their time in main storage may represent only a small 
fraction of their lifetime in the system. 

System Control Block Mames 

A system control block usually reguires two names: the name of the 
dummy section (DSECT) that describes its format, and the symbolic 
address that points to the information described by the dummy section. 
All TSS programs, resident and nonresident, use the same rules to name 
system control blocks. A dummy section name looks like this: 

CHAxxx 

The characters xxx identify the dummy section. All fields used with- 
in the dummy section look like this: 

xxxff f 

The characters xxx are the same as the last three characters of the 
dummy section name. The characrters fff are any three characters that 
identify the field within the dummy section. For example, these are the 
assembler statements for a typical dummy section: 

CHAABC DSECT COITIOL BLOCK lAHE 



ABCPCA 


ns 


IF 


FIELD HAIE 


ABCBJG 


DS 


4F 


FIELD HAHE 


ABCXIZ 


DS 


3C 


FIELD HAMB 


ABCfLG 


EQO 


ABCXTZ 


FLAG HAHE 


ABCFIGI 


EQU 


X«BO» 


FLAG HASK 



Bote that the field name, ABCFLG, is the name of a byte containing a 
flag bit. The field ABCFLGH imn be used as a mask byte in a test under 
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Bask instruction (TI) to test the condition of the flag. Hask naaes are 
of the form: 

XXXfffM 

where xxxfff is the na»e of the duamy section field to which the mask is 
applied. For nore infornation on using a dnnay section^ see "DaaBy Sec- 
tions** below. 

The dummy section is, of course, only a description of information; 
it does not supply anything more than the format of the information it 
describes. Symbolic addresses that point to non -transient areas of 
storage described by dummy sections are named like this: 

CHBxxx 

where the characters xxx are the same as the last three characters of 
the dummy section name. For example: 

DATA DC V (CHBABC) 

DATA contains an address constant pointing to an area of storage 
organized dks described by the dummy section CHAABC. 

lemember, CHA xxx says what the information looks like; CHB xxx says 
where the information is located. The DSICT can be used for both non~ 
transient system control blocks and for transient areas (which cannot 
use CHBxxx) • Symbols generated by macro instructions always begin with 
CHD. For example: 

CHD103 MHOTl 3,»E1R0E» 

might be found in a macro definition. 

Dummy Sections 

The dummy section (DSECT) is used extensively throughout TSS so that 
parts of the system can refer to commonly used data items by symbolic 
names. You can refer to a field in a system control block by the name 
assigned to that field in the dummy section; this frees you from having 
to use the field's numeric location. {Actually, the dummy section supp- 
lies a number of symbolic field names, lengths, and relative positions 
which the assembler translates into numeric displacements.) lou needn't 
worry about the specific physical structure of the system control block 
to which you are referring if you use a DSECT to describe the control 
block. All you need be concerned with is the field structure (bit, 
byte, half word, etc.) . You don't care where the field is located within 
the system control block. Thus, if the field position changes, but the 
field length, boundary alignment, and the meaning of its contents don't 
change, your program will still run properly after it is reassembled. 
Beassembly is necessary since displacement values may have changed as a 
result of using the new dummy section. 

In TSS, the dummy section is more than a programmer convenience. 
Dummy sections for system control blocks, obtained from the assembler 
copy/macro library, ensure that all programs using the same system con- 
trol block use the identic:al format. The set of TSS dummy sections can 
be viewed as a central, current description of all system control 
blocks. 

A typical TSS dummy section is illustrated in Figure 8 under "Linkage 
Convention, •» later in this section. Several conventions apply to dummy 
sections. These conventions minimize the need for redesigning programs 
if the dummy sections they use are changed. Dummy section fields that 
are integral multiples of bytes in length are referred to in a program 
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bf using the naae of the field • Fields that are less than one byte long 
are referred to by using a sask; we mnst do this because the central 
processing unit cannot directly address a field shorter than a byte. 
The nane of the nask associated vith a field that is less than one byte 
long is obtained by adding the character E to the field nane. If ve 
wanted to determine whether the field ¥PSII were a 1, we wight write: 

TE VPSIIpVPSIIl TEST UHDBH HISK 
BZ FIELDOFF BIIHCH IF ZIBO 

The prograwwer doesn't have to know where the field ¥PS1I is located 
within the system control block or what bit pattern defines the Bask 
TTPSAIH. This infomation is supplied by the dummy section which he 
incorporates into his program from the assembler copy/macro library. 
The field he is testing with the Test Under Mask (TH) instruction need 
not be restricted to a single bit. It can be any combination of up to 
eight bits^ as long as all the bits fall within one byte. The condi- 
tional branch instruction can be used to determine if the bits he is 
testing are all l»s, all O's, or mixed. 

For bit fields r the field name is always the name of the byte in 
which the bits appear. Since a single byte can have up to 256 different 
conbinations of bits^ a single byte could have up to 256 different bit 
fields, ie frequently find, therefore, that the names of different bit 
fields are synonomous; that is, they point to the same byte. The bit 
mask corresponding to the field name must be used to extract the proper 
bits. 

The dummy section itself does not take up program storage space; it 
is used exclusively to describe a storage area to which it is applied. 
To properly use a dummy section, first load a register with an address 
constant pointing to a storage area containing information described by 
the dummy section. Then issue a USIMG statement to tell the assembler 
that the corresponding dummy section format is to be applied to the 
storage area pointed to by the register given in the USIMG statement. 
It looks like this: 

L 5,IDC0II 
IISIIIG CHAVPS,5 

assuming that iDCOH has been defined as: 

IDCOl DC ¥ (WOBKAIBA) 

This would apply the format given by CHAVPS to the storage area be- 
ginning at the symbolic location WOBKAREA. 

You can define your own dummy sections and use them as you see fit. 
In most cases, though, you will get the dummy section from the assembler 
copy/macro library (see Section 4, "Generating and Maintaining TSS"») by 
issuing a COPY statement with the name of the dummy section as the 
operand. Here is an example: 

COPY CHAVPS 

The dummy section on the assembler copy macro-library is included in 
your program at the point of the COPY statement. This enables you to 
symbolically refer to the system control block CHAVPS (see System Con- 
trol Blocksl . 

EMABLIIG AID DISABLIMG IHTERROPTIOIS 

Because they operate in the supervisor state, resident programs can 
enable and disable interruptions by setting and resetting the system 
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■ask or bf altering tlie contents of extended -control registers. The 
instrucrtion 

SSM =X«00» 

sets bits through 7 of the extended program status word to zero* The 
processing unit affected interprets these bits as: program event reco- 
rding off^ address translator off , and I/O and external interruptions 
disabled. To restore interruptions^ 

SSM =X«03» 

is interpreted by the processor as: program event recording off^ 
address translator off, and I/O and external interruptions enabled. If 
you vish to modify the extended-control registers, the instructions: 



STCTL 2,2,S1V1 

L 6,S1VB 

II 6,=X*BFFfFFFF« 

ST 6,SCBATCH 

LCTL 2,2,SCBITCH 



save the contents of control register 2 and disable interruptions from 
channel 1 (as viewed by the processing unit issuing the ICTl) • The 
instruction: 

LCTL 2,2,SI?E 

restores the original contents of control register 2. The work areas 
for Sl?l and SCBiTCH would be obtained using the supervisor core alloca- 
tion subroutine. 



SUPllflSOR LIIKAGB C0I?EITI01S 

A resident program links to subroutines by using (1) a T-type address 
constant or (2) an A-type address constant and an llTEl statement* 
Startup resolves all symbolic references among resident programs, and 
supplies the correct values for the address constants, lesident pro- 
grams never use 1-type address constants (they do not contain prototype 
control sections) . One resident program transfers control to another by 
a Branch -and -Store piSl) instruction. Iny understanding between the 
calling and the called programs concerning the contents of the general 
registers is arbitrary and depends on the particular programs involved. 
The calling program must know what register the called program is using 
as an entry base register. To transfer control, the calling program 
loads the address of the called program's entry point into the called 
program's entry base register, like this: 

L BASE, =? (en try point name) 

Then the calling program branches to that entry point: 

BASR 1<I,B1SE 

The called program expects its entry base register to contain the 
address of its entry point. The called program usually begins like 
this: 

OSIHG *,BJlSE 

to tell the assembler that register BASE contains the address of the 
called program's entry point when control is transferred. 
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To standardize program linkage t TSS resident supervisor uses a Coamu- 
nication fector Table (C¥T) . Thie C¥T cx>ntains all the entry points for 
TSS supervisor Bodmles. I aacroj. ICILL, wiU load the entry point 
address in register 15 and link to the called program with a BISB 14,15. 

To standardize linkages and provide some traceback information, two 
I ttacros, SIfEE and lETlHl, are used* These are used in the saae area as 
that used by the GITWORK macro* 

Programming Convention Coffiments 

There is no requirement for resident programs to use particular regi- 
sters as base registers, return registers, or parameter registers; how- 
ever, almost all resident programs use these registers: 

legister ~ parameter register 

legister 1 • — parameter register or address of parameter list 

legister 1^ -- return address of calling program 

legister 15 — entry point of program being called 

Because of these register assignments, most programs being called begin 
with: 

USING *,15 

and end with: 

B3. 14 

or the equivalent* 

k number of resident programs, such as SfC processing routines, re- 
turn control to a location pointed to by a ?-type address constant 
instead of branching to the address contained in register 14* For 
example: 

THIU 1 14,IIDC13 GET lETUEM IDDIESS 

BE 14 TlIlSFEt COITEOI 

IBCHB .DC f {ClIHIB) IDDB SfC Q PEOC BETOEM 

is the way that an SfC processing routine can transfer control back to 
the supervisor call queue processor. This is done because most SfC pro- 
cessors require two common functions to be performed, and this portion 
of the SfC queue processor provides them with the functions. 

MQMIESIDEIIT PfiOGBAt SS 

PlIflLEGED PIOGIIH CONfEITIOIS 

laming Conventions 

Is discussed in the section about naming resident supervisor pro- 
grams, all TSS module names begin with the letter C. All privileged 
module names have the form: 

CZxxx 

where the characters xxx identify all module names beginning with CZ. 
Ill control section names and entry point names of nonresident privi- 
leged modules add a character to the end of the module name to form a 
unique entry point or control section name • This is analogous to the 
way entry point and control section names are formed for resident super- 
rvisor modules. For example, an entry point of privileged module CZCJT 
might be CZCJTH. 

Dummy sections for system control blocks are used by nonresident pri- 
vileged programs in the same way that they are used by resident supervi- 
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sor programs. Ill sfstea duaay section names begin with CHlj the loca- 
tion of the first byte of data described by a system dummy section is 
named by a label beginning with CHB. CHAXT2 is a dummy section describ- 
ing data located at a virtual storage address egnivalent to CHBXXZ. 

The dynamic loader treats all external symbols beginning with the 
characters SIS as system names. (& control section without either the 
PRfLGD or SYSTEM attribute cannot define system names as external sym- 
bols.) (See Figure 41 for the effect of authority codes in dynamic 
loader processing.) 

Writing Privileged System Programs 

Virtual storage (that is, nonresident) system programs are divided 
into two classes: programs that make up initial virtual storage and 
programs that are dynamically loaded. Initial virtual storage (IVI) is 
composed of all those system programs (both privileged and nonprivi- 
leged) needed to dynamically load a program and those system routines 
that are frequently used by an installation. Privileged programs that 
are not part of I?E are brought into virtual storage,, as required, by 
the dynamic loader and the miscellanous programs it uses for assistance. 

In writing a system program, you must know whether a program to be 
called is in IfM or not. Any program in ITl should not be explicitly 
called since this causes unnecressary system processing. 

The use of the 1 option in the CILL requires action by the dynamic 
loader; only programs outside of I¥l may use CALL with the 1 option. 

Almost all TSS programs can be shared by several users. When a pro- 
gram is shareable, or public, it must be put together in a special way. 
Each public program is thought of as consisting of two parts. 

One part is made up of all the instructions and data in the program 
that never change because of relocation in virtual storage by the dynam- 
ic loader or because of execution by a processing unit (variables) . 
This part of a public program is constant; it never changes under any 
circumstances . 

The second part of a public program consists of those parts that may 
change because of relocation or execution: the program's address con- 
stants and variables. 

The parts of a public program that may change — the address con- 
stants and variables — are collected in a prototype control section 
(PSECT) . All other control sections of a public program should be given 
the attribute IBADONLl, since they can never be modified. Exceptions 
are the tables, such as the symbolic device allocation table (SDAT) , 
that are protected with lock bytes and are shared, nonread-only control 
sections. The division of a public program into prototype control sec- 
tions and read-only control sections allows a number of different tasks 
to share the same program without destroying one another's results. 
This is accomplished by giving each task that is sharing the public pro- 
gram its own private copy of the prototype control section, while allow- 
ing each task to share a single copy of the read-only control sections. 
In this way, each task has a private copy of those parts of the public 
program that may change, thus preventing tasks from destroying one ano- 
ther's variables and allowing each task to have its own address 
constants. 

You should take care not to confuse intertask reenterability with 
intratask reenterability. The use of prototype and read-only control 
sections permits programs to be shared among many different tasks; this 
is intertask reenterability. The use of a prototype control section for 
storing variables does not automatically guarantee that, within a single 
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task, a pix>gra» can be reentered. Ill programs are freelj interrmptable 
by anf real (not virtnalj interrnption. then suck an interruption 
occurs, before comtrol is returned to tbe interrupted prograa in virtual 
storage, the resident supervisor cbeclcs wbetlier there are any pending 
task -interruptions. If there are pending task-interruptions, if the 
corresponding task -mask bit in the virtual progran status word is set to 
1 (enabling task-interruptions) and if the ISA lock bjte is zero, con- 
trol is returned aot to the interrupted program, but to the task moni- 
tor. !Fhe task monitor, after some housekeeping, transfers control to 
the appropriate task-interruption-handling routine. In some instances, 
the interruption handler may have to use the interrupted program as a 
subrotitine. then this happens, the interrupted program is being reen- 
tered. It is thus: task-interruption sensitive 'and it must be con- 
structed to allow for this sensitivity. The prototype control section 
is no help in permitting intratask program reenterability since, within 
this single task, there is only one prototype control section for each 
public program and only one copy of variables and address constants can 
be preserved in it . 

Although address constants change as a result of program relocation 
and are placed in a public program's prototype control section, and may 
assume different values from task to task, they are not considered 
variables within a task . Once supplied by the dynamic loader (or by 
startup for I?MJ , an address constant within a given prototype control 
SBOtlon will not change. 

Within a single task, we are concerned about those parts of a program 
(public or otherwise) that change as a result of that program's execu- 
tion by a processing unit. If a program that stores variables in fixed 
areas of virtual storage can be called by a number of other programs, it 
must protect itself against task -interrupt ions. If a program must be 
interr up table (by task -interruptions! , it must use GETHIIE (or something 
eguivalent) to dynamically allocate virtual storage and thus prevent the 
accidental destruction of variables. GST and PWT are examples of pro- 
grams that can be in use by one program, interrupted, and reentered for 
use by another program within the same task. 

If, in a privileged program, you want to disable task -interruptions 
during some processing, you can use the macro instrucrtion ITI (inhibit 
task interruptions! ; to enable task-interruptions, the macro instruction 
Pfl (permit task interrupts) may be used (see Appendix A) . For example: 

LOCK ITI DISABLl TASK IITBIIUPTIOIS 

IISCHLAIIOUS IlTBllUFTIOW-SllSITIfB COBIHG 

. 

PTI llABLl TASK IITIRIOPTIOIS 

shows how task -interruption might be disabled and restored in a program. 

Excluding dummy sections, which are not true control sections (see 
••Dummy Sections") , you may have two kinds of control sections in your 
program: prototype (PSECT) and nonprototype (CSBCT) . From the stand- 
point of the dynamic loader, there is very little difference between a 
PSBCT without gualifying attributes and a CSBCT without qualifying 
attributes. Throughout TSS, however, PSECTs are used in public programs 
to contain address constants and variables; you should think of proto- 
type control sections as the private part of shared program modules. 

Be careful not to confuse the attributes PlIFLGB and STSTBl. PlIVLGD 
includes SYS TBI; every privileged program is a system program as far as 
the dynamic loader is concerned. S7STEH does not necessarily include 
PH¥LGD, however; every system program is not privileged. 

Section 3: System Programming Conventions 23 



Tom Biglit code a sa«ple privileged program like this: 

TITLE •SliFLl F1I?ILSG1D PIOGIII • 

DCLISS B1I¥IL1GBB TEIS ILLOIS FlI? 

eiCEO IIPIISIOIIS 

COP¥ CHIISl GIT FOllIT OF 

ISI 
CZ&BF FSECT FIVLGD FOT ILL THE 

IBCOIS IID 
VIBIIBLES HERB 

EXTII CeiXfZ LOCITIOI OF 

TIBLB XIE«S DITI 
CICIBC CSECT EE1D01LY,F1IBLIC,F1¥LGB FTOB FIOCBDTOB 

SECTIOI IlITHIIG 
lElB BUT IDCOIS 
IIB V&II&BLBS 

BIB CZIBC 



lOIFlIflLBGBB FlOGllKS 

Tkere isn't a great leal of difference betveen a privileged and a 
nonprivileged system program j almost everything written above about pri- 
vileged system programs applies to nonprivileged system programs. The 
most significant difference between them is that nonprivileged system 
programs operate with an extended program status word protection key of 
1; they cannot read or write privileged control sections. 

FlOGl&M BBSIGl COISIBBIITIOIS 

In thinking about nonprivileged programs ^ don't confuse the privilege 
of a program with the authority of the programmer who directed that the 
program be loaded. Bespite any assembler language declarations^ any 
program you write is implicitly a system program as long as you log on 
using your user IB with a F or authority code* Remember that all sec- 
tions you load using your P or O authority aodm are private; the dynamic 
loader ignores the PUBLIC attribute. Only a task having a U authority 
code can load a control section having the PUBLIC attribute ^ and then 
only if the module crontaining the control section is in a shared data 
set. (1 module requiring more than 256 shared pages will not be loaded 
as public, however; the module will be loaded with private pages.) 

& fence-fitter is a system module that assumes the privilege of the 
calling module. Such a module should not be designed to issue privi- 
leged S¥Cs based on the authority code of the user. If this were done, 
and a programmer with a user authority code (B) attempted to use the 
fence-sitter, he wouldn't succeed. To be on the safe side, when you 
write system programs, you should always give the control sections the 
attributes they need to be able to run; do not rely on your authority 
code unless all intended users will have an equivalent authority code. 

Ion privileged system programs accessible to user programs have module 
names that begin with SIS. Inalogous to the resident supervisor and 
privileged programs, control section and entry point names are formed by 
adding a character to the end of the module name. For instance, SISIBC 
is an entry point in the nonprivileged system program SI SAB. lames be- 
ginning with SYS can be freely referred to by all programs, privileged 
or otherwise; SIS names can only be defined by control sections with the 
SlSTEl attribute (see Ippendix B for further details) . 

Monprivileged system programs not accessible to user programs gener- 
ally use symbols beginning with CB. 
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The purpose of a linkage conveation is to standardize the aethod of 
transferring information and control fron one prograa (the calling pro- 
gran) to another (the called program) • Standardization allows the nse 
of systen aacro instructions for the generation of prograas* fSS uses a 
number of linkage conventions designed to fit a Tarietf of situations 
while att^ipting to keep the c^onventions as similar as possible. 



TSS linkage contentions reguire the calling program to supplj a save 
area for use bj the called program. A save area is an area of virtual 
storage, accessible to the called program, in which it can save the con- 
tents of registers, if necessarj • llso, a save area contains forward 
and backward pointers to other save areas, forming a chain. If one pro- 
gram calls a second, and the second program calls a third, the pointers 
relate the respective save areas. Thus, if fou know where one save area 
is located, jou caa find the others. The format of the save area usBd 
in fSS is shown in Figure 7. 



The four basic linkage conventions followed by TSS programs residing 
in virtual storage are summarized in Figure 8. lote that tjpe-1 has a 
variation (type 11} # waking five ways to link programs. These are the 
only linkage conventions in use among virtual storage program in TSS. 
Ill TSS programs are constructed to receive or transfer control, using 
one of these linkage types. To add to or modify TSS programs you must 
use these linkage conventions. 



In general, TSS system programs use macro instructions for linking 
programs. Some macro instructions generate more than one type of pro- 
gram linkage; for example, GITHIIB can generate either a type-1 or a 
type-2 linkage. 



The called program freguently does not know which linkage type was 
used to transfer control to it; usually, it does not need to know. 
There are exceptions which are cx>vered later. The linkage type must be 
known by the calling programs, since it is the calling program that sup- 
plies the linkage instructions, save area, and register contents. 
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Figure 7. Format of the stand^ard save area 



26 



Type 


Transfer 
Control 
via 


Save-area 
Format 


Parameter 

Registers 
(maximum ) 


Entry-Point 

Address in 
Register * 


Return 
Address in 

Register 


Sove-Arec 
Address in 
Register 


PSECT 
Address In 
Register ** 


1 (normal) 


BASR 


Standard 


GPR 1 


GPR 15 


GPR 14 


GPR 13 


N/A 


2 


SVC 121 
(ENTER) 


Standard 


GPR 0-1 


GPR 15 


GPR 14 


GPR 13 


N/A 


lM/2 


BASR or 
SVC 121 
(ENTER) 


Standard 


GPR 1 


GPR 15 


GPR 14 


GPR 13 


N/A 


3 


CALL(CZCJL) 
Leave-Privilege 


Standard 


GPR 1 


GPR 15 


GPR 14 


GPR 13 


N/A 


4 
(restricted ) 


BASR 


None 


GPR 0-6 


GPR 15 


GPR 14 
i 


None 


GPR 13 



* Also used for return code, if any. 

** Very often, but not olways, the PSECT and the save-area address are the sarre. 

Fifure 8. firtmil prograa linkage coiiveiitioiis 

TTPl-1 LIIKIGB 

Tfpe-1 (ia so«€> publications, shown as ••trpe-I") linkage is nsed for 
transferring control and inforaation between two programs of the same 
privilege. I nonprivileged program may not use type-l linkage to call a 
privileged prograii; a privileged program mmj not nse tfpe-1 linkage to 
€:^11 a nonprivileged program. Tfpe-*1 linkage involves these 
conventions: 

• Using the standard save area 

• Using specific registers for designated functions 

• Using the Bramch-and-Store instruction for the transferring of 
control 

• Preserving registers. 

Use of the Save Irea 

fon will find it helpfnl to refer to Fignre 7 for the following dis- 
cussion. Whenever a program nses tfpe-1 linkage to call another pro- 
gram, the calling program must snpplj a save area for nse bj the called 
program. Before transferring control to the called program, the calling 
program puts certain information, if applicable, into the save area, 
fhe calling program is required to preset some fields of the save area; 
it maf preset others. !Phe first word of the save area (SAVLll) mnst 
contain the length, in bytes, of the save area fminimiim 76 bytes) and 
any appendages to it. The 19th word of the save area (SIVPC1?) mnst con- 
tain the 1-type address constant CK""^:^^) of the entry point to which the 
calling prog am is transferring control. 

The 1-valne is the address of the control section in which the entry 
point is defined. The technigne in TSS for associating a modifiable 
control secHiion with a nonmodif iable , reenterable control section is to 
place the definition of the entry point to the reenterable control sec- 
tion Cthe HTBX statement) in the control section that is to be modifi- 
able (nsnally a prototype control section) . Thns, the l-type address 



Section 3: System Programming Conventions 27 



constant, for a sj mbol which, is an entry point to the reenterable part of 
a program provides the address of the modifiable part of that program. 
In addition to naming an entry point , an 1-con can be established for a 
control section name or an object module name. Xf a control section 
name is used, the E-valme points to the beginning of the control sec- 
tion. If a Bodnle name is used, the l-valne points to the first proto- 
type control section contained in the module. If the module does not 
have any prototype control sections, the l-valne points to the first 
nonprototype control section. 

One other field that must be set by the calling program, prior to 
transferring control to the called program, is the second word (SifBPf) 
of the save area. This field is a pointer to a save area used by the 
calling program when it called. The calling program may not be using a 
save area, thongh, and this field may contain zero. If this field does 
not contain zero, the called program may assume 4:hat it points to the 
save area being used by the calling program. 

lU other fields of the save area may contain anything. The called 
program should not assume that fields other than the length field, the 
1-con field, and the backward-pointer field contain meaningful 
information. 

After receiving control, the called program must save the contents of 
all the general registers, except register 13, in the save area, it the 
time the called program receives crontrol, register 13 contains the 
address of the save area. The other registers are stored in the save 
area by using register 13 as a base address; e.g., STl 1^,12,12(13) 
saves all the general registers, except 13, in the proper locations of 
the save area pointed to by register 13. If the called program wishes 
to use register 13 for its own purposes, it must save register 13 in the 
backward pointer of its save area. If the called program is going to 
call another program, and is going to provide a save area for that pro- 
gram, it must store register 13 in the second word of that save area. 
In this instance, register 13 serves as the backward pointer. Optional- 
ly, the user can store register 13 someplace else, not in a save area. 
If you save register 13 in a save area that you make available to anoth- 
er program, you depend on that program not to write over the save area. 
If that program is unreliable, you might want to save register 13 in an 
area accessible to your program alone. That precaution will enable you 
to restore the registers regardless of what the program you call does to 
the save area you provide. 

The called program does not need to save and restore the floating- 
point registers. If the contents of the floating-point registers are to 
be preserved, it is the responsibility of the calling program to save 
their contents and the contents of its interruption mask. 

Contents of the General legisters 

legisters 13, 1ft, and 15 must be preset by the cralling program, 
legister 13 must contain the address of the first byte of the save area 
that the calling program is providing for the called program. This 
address must be on a fullword boundary; that is, the two low -order bits 
of the address must be zero, legister 1ft must contain the address to 
which control is to be returned by the called program, legister 15 must 
be set to contain the address of the entry point in the called program. 

I number of macro instructions can be used to generate type-1 link- 
ages to specific programs. Examples of these macro instructions are 
CILL, GET, PUT, OPEl, and CLOSE. In using CALL, you specify the name of 
the program to which you want to transfer control; in using GET, howev- 
er, the name of the program to which control is to be transferred is 
supplied by the macro instruction. 
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Tlie called program always uses register 15 as a return-code register, 
if retiirn codes are applicable. If a parameter list is passed in 
register 1, tliere must be an understanding between tbe called and call- 
ing prograns as to its content. In variable-lengtb lists, the word pre- 
ceding the first word of the parameter list contains a connt of the nun- 
ber of parameters in the list. Each following entrj is the address of a 
parameter that has been prestored. lote that in c^ommand sjstem rou- 
tines, a ▼ariable-Length list is almost alwajs assumed. 

Transfer of Control 

k type-1 linkage always causes control to be transferred from the 
calling program to the called program bj using the Branch-and-Store 
(BlSl) instruction • Specifically, the resident supervisor is newer used 
to assist in transferring i^ontrol (no interruption occurs) , since the 
calling and the called programs hawe the same privilege. 

legister 1 may be preset by the calling program with the address of a 
parameter list, legister 1, 13, 14, and 15 are the only registers used 
by type-1 linkage. 

The CILL macro instrucrtion should be used to generate a normal type-1 
linkage. The use of CILL is discussed in Assembler User Hacro 
Instructions. 

BIAHPLE : I prograii transferring control to another program via a type-1 
linkage might use these instructions: 

L 13,^1 (SAfEllA) LOCATIOl OF SFICI FOB STI10IBD 

* SA¥B IBBA 

IIDICITE FOBIIT 
GET 1-COW OF CALLED PIOGIAB 
STOIB 1-COll II SAVE AlEA 
GET ABDIESS OF BITBT FOIIT 
SET :roiITBfi TO FAIAHBTEB LIST 
PUT IBTUBl ABBIBSS II 6P1 IH 

♦ AID BBAICH 

The program receiving control might use these instructions: 

HAKE lAHE SBBl EITEllAL 
SA¥B ALL BEGISTSBS 



US lie; 


CBASAV,13 


L 


6,=B(SUBE) 


ST 


6,SA?PCT 


L 


15,=V(SBB1) 


L 


1,=A(PA1LISTJ 


BASB 


1i»,15 



XIZ 


PSECT 




EHTBT SOBB 


ABC 


CSBCT BBIDOHLT 


SOBB 


STH 111,12,12 (13) 


LB 


14,13 


L 


13,72(13) 


ST 


13,8 (HI) 


ST 


H»,«(13) 



to save the general registers and establish definitions for the ?-cons 
and B-€X>ns of the name SUBB. then its processing is finished, the pro- 
gram SOBB might do this: 

EXIT LI 1^,12,12(13) BESTOBE BEGISTEES 
LA 15,% SET BETTOl CODE i| 

BE 14 BBTUBW TO CALLIB6 PBOGBAB 



TYPE -2 LIWIOIGE 

ipjpQ.2 linkage is used when the calling program is nonprivileged and 
the called program is privileged. All programs designed to be called 
via type-2 linkage run in the privileged problem state. Type-2 linkage 
involves these conventions: 
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• Using the standard save area 

• Standardizing the content and use of the general-purpose registers 

• Standardizing the method of transferring control 

• Preserving registers- 

fhe Save Are a 

fhe standard 19-iford save area is nsed in tfpe-2 linkage (see Figure 
7) . Onlike type-1 linkage, the calling prograa does not provide this 
save area. Instead, it is provided by the task monitor, which trans- 
lates the tjpe-2 linkage into what appears to the called program to he a 
modified type-1 linkage. The transfer of control from the calling to 
the called program is through the supervisor when tfpe-2 linkage is 
used. Coding contained in the task monitor is, therefore, an integral 
part of the linkage. 

Before passing control to the called program, the task monitor 
initializes a save area for the called program's use. The length field 
(SAVLEN) contains a bf te count of 76 (decimal) ; the backward pointer 
(SAfBPT) is zero. The last word of the save area (SI¥FCT) contains the 
E-con of the entry point of the called program. All other bytes of the 
save area are unpredictable. All programs designed to be called via 
type-2 linkage can assume that the save area pointed to by register 13 
is arranged in this way. 

Content and Ose of the General Beqisters 

Type-2 linkage conventions assign special functions to registers 0, 
1, 13, 14, and 15. The calling program is responsible for presetting 
registers 0, 1, and 15. The calling program loads register with a 
parameter that is not an address or, occasionally, the address of a sys- 
tem control block; it loads register 1 with a non-address parameter, or 
a parameter list address, or the address of a system control block; it 
loads register 15 with a code, called an IITIE code. The llTll code 
identifies the program to be called as would an SVC code in other sys- 
tems, ihen control is returned to the calling program, the contents of 
registers 2 through 14 will be unchanged* Begisters and 1 may be used 
by the called program for returning results. If the called program sup- 
plies a return code, it must use register 15. 

The task monitor saves all the general-purpose and floating-point 
registers in its own save area; the task monitor builds a save area for 
the called program "s use, as described in the previous section. The 
task monitor sets a pointer to this save area in register 13. The con- 
tents of registers and 1 are set as received from the cmlling program. 
Begister 15 is set to the address in the called program to which the 
task monitor will transfer control. This address is determined by the 
task monitor, using the EITEB code that was in register 15 when control 
was received by the task monitor. Begister 14 is set to the address in 
the task monitor to which control is to be transferred by the cmlled 
program when it has executed. The contents of registers 2 through 12 
are unpredictable; they should not be assumed, by the called program, to 
be significant. 

The called program must save the contents of the general registers, 
since the task monitor requires the contents of the registers passed to 
the called program to remain unchanged. The called program must return 
control to the address in register 14. The called program may put a re- 
turn code in register 15; it may put results in registers and 1. 
Begisters 0, 1, and 15 will be passed back to the calling program as 
they are received from the called program when it returns control to the 
task monitor. 

30 



SB 


1,1 


Li 


0,76 


L& 


15,48 


SVC 


121 



Transfer of Control 

The calling program transfers control to tke called program bf issu- 
ing SIC 121. 

In SVC 121 can be generated bf issuing tbe ll!ras macro instrnction* 
SfC 121 passes control tbrongk the task monitor to the called program. 
Host of the time ElffEB is used as an inner macro instruction. For exam- 
ple r the macro instruction GBTHIIl generates an EITEl if the program in 
vhich GSTHAIV is issned has been declared bj the programmer to be non- 
privileged (DCLASS USEE) . Ill programs that transfer control via S?C 
121 must adhere to type-2 linkage conventions. 

EXAHPIE : Assume that fon want to get 76 bftes of virtual storage ^ pos- 
sibly for nse as a save area; fon might code it like this: 

SET OPTIOIS: lOIPHVIlEGEB^ VIII ABLE ^ BYTE 

BITE COOIT IS 

EITBl CODE m ~ GETIAII fBITB) 

flAISFEl COHTIOI. 

Control will be returned to the instrnction following the SVC after SET- 
HAIl has been ezecitted. If you had wantedL to nse the macro instruction 
6ETHAI1, yon conld have written, GETHAIl l,LV-76 which would have 
generated equivalent (]^Tet&r:md} instructions. 



TyPE-lH/2 LIIKAGB 

Type- 11/2* linkaige applies only to called programs that can be called 
via both type-1 ani type-2 linkages. Programs called by type-2 linkage 
are always privileged programs. The calling program, however, may be 
privileged, in which case a modified type-1 (type-IH) linkage is used 
(with both registers and 1 usable as in type-2 linkages) ; or the call- 
ing program may be nonprivileged, in which case type-2 is used. Since 
the task monitor makes all type-2 linkages appear, to the called pro- 
gram, as type-1, the called program ordinarily is not affected by the 
privilege of the calling program. 

If a privileged program is being called via type-11/2, it may need to 
determine the privilege of the caller. It can do this by comparing the 
return address in register 14 to the address of the point in the task 
monitor to which control is returned when a type-2 linkage has been 
used. For example: 

CL 14,=V(CZCJEH) COHFAIE GPl 1«l TO TfFE-2 lETUlI 
BE IPCUl IF EQIFIL, CALLEl IS MOIPIIVILEGBD 

IF OlEQUAI., CALLEl IS FlIVILEGED AID 

TYPE-l LIllAGE IS USED 

If the iralling program is nonprivileged, the privileged called pro- 
gram must issue a CKCLS or a PIIEC macro instruction on all addresses 
passed to it from the nonprivileged routine to insure that it won't 
change a privileged address for the nonprivileged program. The calling 
program uses either a type-1I or a type-2 linkage as described previous- 
ly; if the called program can be called by either of these linkage 
types, it is using type-lH/2. The calling program treats this linkage 
as described under type-2. 



♦The use of 1 with type-1 linkage indicates that register may also be 
used as a parameter register - in addition to register 1. legister 
may contain a parameter or a pointer to a system control block. 
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TfFE-3 LIIiCIGl 

ffpe**3 linkage is used vhan the calling pirograa is privileged and the 
called prcgraB is nonprivileged. Jill progiraas designed to receive con- 
trol bj a tjpe-3 linkage are designed to run in the nonprivileged state. 
Tjpe-3 linkage involves standardizing: 

• fhe save area 

• The content and nse of the general-purpose registers 

• The aethod of transferring control 

• Preserving registers. 

The Save Are a 

Type-3 linkage requires the standard 19-word save area; however, the 
save area is not supplied bf the calling prograa. It is supplied bj the 
Leave Privilege subroutine of the task aonitor. The calling program 
calls the Leave Privilege subroutine, which supplies and initializes a 
save area for use by the called prograa (see figure 7} . The l^ave Pri- 
vilege subroutine establishes a 19-word save area which is not read- or 
write-protectedj the nonprivileged called prograa can gain access to it. 
The Leave Privilege subroutine sets the first word (SIVLII) equal to 76. 
The last word of the save area (SIVPCT) is loaded with the B-con of the 
called program's entry point. The calling program supplies this 1-con 
to the Leave Privilege subroutine which inserts it into the save area. 
The remaining 17 words are unchanged. 

Content and Use of eeneral-Purpose Begisters 

fjpQ.j lini^age standardizes the use of registers 0, 1, 13, 11, and 
15; the contents of the other registers are as they were at the time the 
privileged program was entered. The c^ontents of the other registers 
will be returned, intact, to the calling program. Begisters and 1 are 
used as in type-2 linkages. These registers are passed to the called 
program as received by the Leave Privilege subroutine from the chilling 
program. The Leave Privilege subroutine loads register 13 with a point- 
er to the save area it is supplying for the called program. It loads 
register 15 with the address of the entry point in the called program to 
which it will transfer control. Then it loads register 14 with the 
address of an SVC 120 pSPBV) instruction, which is in the part of the 
interruption storage area (ISJL) that nonprivileged programs can read and 
write. 

Transfer of Control 

Control is transferred from the calling program to the Leave- 
Privilege subroutine with the standard type-1 linkage. Control is 
transferred from the Leave Privilege subroutine to the called program by 
an SVC 251 (LVPSl) . The use of type-3 linkage always results in an SVC 
interruption • 

BIAMPLB ; Within a privileged program, if you want to call a nonprivi- 
leged subroutine, you might write: 
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PIIAETIS 



IBCOHS 

PIRIH 1 
PI1AH2 



L 
L 

ST 
LI 

L 

BlSl 

DC 

DC 

DC 

DC 

DC 

DC 

DC 



13^=1 (SIHBIIEII 

14^=1(C2CJLE) 

14^72(13) 

I^PIfilHTHS 

15,=?CCZCJL1) 

14,15 
k CADCOIS) 
I (PIBAH 1) 
A(PARIH2) 
f (CALLED) 
1 (CALLED) 

F»54» 



GET iDDlESS Of SI¥E IlEI FOl L?P1? 

R-COl OF LEI?B~PRI?ILBeB SOBRODTIIE 

POT 1-COl II 19TH WORD OF S1¥E AREA 

PARAMETER LIST IITO GPR 1 

BMTRl POIMT OF LEAfE-PRITILEGE 

SUBROUTIIE 

TRAISFER TO LEA¥E-PRIVILEGE SOBR 

POUTER TO ¥- AID R~C01S 

POUTER TO PARAMETER 1 

POUTER TO PARAMETER 2 

BlTRf POUT OF CALLED ROUTIIE 

R-COl OF EMTRY POUT 

PARAMETER 1 

PARAMETER 2 



The Leave Privilege subroutine will get space to set up a save area 
for use by the called progran. It will load parameters one and two into 
general registers D and 1* It will set up registers 13, 14, and 15, as 
described previously, and transfer control to the called progras via an 
S¥C 254 (L?PSW) . 

ihen the called program has been executed, it might return control 
like this: 



LA 


I),RES0LT1 


RETIRI OF RESULTS 


LA 


1,RESULT2 


TO CALLIIG PROGRAM 


BR 


14 


RETURl TO CALLER 



General register 14 points to an S¥C 120 (RSPRV) which will cause the 
Restore Privilege routine to be entered. The Restore Privilege routine 
will restore the calling routine's original register contents, without 
disturbing registers 15 (the return code register) , 0, and 1 (the result 
registers) • 

TIPE-4 (RESTRICTED) LIllAGE COMVEITIOIS 

Type-4 linkage is used by TSS programs under restricted circumstances 
for the sake of limkage efficiency. It is found principally in the cod- 
ing of the language processors. 

Type-4 linkage iiay be used between two programs if all these condi- 
tions are met: 

• Both the called and the calling programs use the same prototype con- 
trol section (PSECT) . 

• The values of address constants reguired for the linkage have al- 
ready been supplied by the dynamic loader. 

• The called program is not designed to accept type-1, -2, or -3 lin- 
kage at the same entry point to be used for type-4. 

• Both the called and the calling programs have the same privileges. 

i[»yp^_il i£u)^age conventions standardize the use of the general regis- 
ters and the method of transferring control. There is no standard save 
area for type-4 linkage. 

Ose of the General leciisters 

Registers through 5 are used by type-4 linkage as parameter regis- 
ters or as pointers to parameter lists. These registers may be used by 
the calling program to supply information to the called program, or by 
the called program to return information to the calling program. In 
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geaeraly thm calling prograii anst not assii»e that the contents of any of 
tkese registers will be returned intact by the called program* It is 
the responsibility of the calling program, to load the address of the 
comaon PSICT into register 13 before transferring €:ontrol to the called 
prograa.* The calling program aiist set, in register 15,. the address of 
the entry point to which it will transfer control? the address to which 
control is to be retamed is set in register 14 • The called program 
uses register 15 as a return code register ir if applicable. The contents 
of registers 6 and 7 are iaaaterial; neither program should make assump- 
tions about the contents of these registers* legisters 6 and 7 need not 
be sa¥ed by the called progra»«. 

The contents of registers 8 through 12 mnst be saved by the called 
program if the «mlled program changes them. The calling program may es- 
tablish any of registers 8 through 12 as coaaon registers; the calling 
program may do this only if it has not been called by a type-4 linkage. 
1 common register is a register whose function is understood similarly 
by the calling and the called programs « If the function performed ^^^by a 
common register, sEch as pointing to a crontrol block, is required by the 
called program, the called program may assnae that the contents of the 
common register cam be msmd., as antnally understood between the calling 
and the called programs. The function of common registers must remain 
constant in all programs called, in turn, by the called program; their 
functions must be returned intact to the calling program* The designa- 
tion of common registers and the natnre of their contents are not part 
of this convention; the use of common registers are an understanding be- 
tween the calling and the called programs. 

Transfer of Control 

Control is transferred to the called program by using the 
instruction: 

BESl 14,15 

Ihen using type-% linkage, interruptions must be masked off; if an 
interruption occurs, an unrecoverable system error will result. 

LIIKIGI COIVEITIOI COllllTS 

This discussion omits type-^ linkage, which is found principally in 
the TSS assembler, FOITIII and PL/I compilers, and the linkage editor. 

Type-4 linkage is used to -minimize the overhead associated with program 
linkage by capitalizing on certain situations that occur in those 
programs • 

We can look at program linkages in two ways: the calling program is 
the activator; it organizes the linkage information and transfers con- 
trol. The called program has a more passive role; it receives control 
and assumes that the linkage information has been organized according to 
the rules, for some linkage types, a program is inserted between the 
calling and the called programs; this program performs some of the du- 
ties normally associated with the caller. In type-2 linkage, the task 
monitor's Inter routine is interposed between the calling and the called 
programs; in type-3, the Leave Privilege subroutine is between the call- 
ing and called programs. 

From the viewpoint of the called program, most callers look the same. 
■Pyp^^l lini^age doesn't use register 0; the other linkage types may. 
This is the principal difference from the called program's viewpoint. 
The called program may return the contents of register to the caller 
when type-1 is used; for the others, the contents of register 0, if not 
meaningful, can be ignored. Because of this similarity of appearance to 
the called program, many called programs can be written in much the same 
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way. for instance, the SA¥1 macxo instruction can be used to saTe the 
contents of the registers in the standard saTe area supplied bf the 
calling progran, and the 1E!IMJ11I macro instruction can be used to restore 
the registers, load a return code, and return control to the caller* 
The macro instructions SI¥1 and lETUlV applf to tfpes-1, 1H, 2, and 3 
linkage. 



FllCB-SIflSlS 

there are a nnaber of programs in TSS that ha^e no bnilt-in privi- 
lege; these programs assume the privilege of the calling program, fhef 
are called ••fence-sitters *" 

Linkage to Fence-Sitters 

Fence-sitters caia be called through a tfpe-1 linkage by either a pri- 
vileged or a nonprivileged routine. These routines are assigned a hard- 
ware storage protection key that makes them read-only to nonprivileged 
routines, ihenever a type-1 linkage is performed, the FSl protection 
key is unchanged. Therefore, when called from a nonprivileged program, 
a fence-sitter roat:Lne is a nonprivileged routine. Whenever a fence- 
sitter service routine is called from a privileged routine, the PSl pro- 
tection key is zero,, and the fence-sitter becomes a privileged routine. 
This convention is established to efficiently transfer control to those 
system service routines that link to other (privileged) service routines 
inf reg nently . 

Some fence-sitter routines have initial entry point names beginning 
with the letters S7S. This distinguishes them from service routines 
that must be linked to from a nonprivileged routine through the lITll 
mechanism. Other fcince-^itter routines are linked to from macro in- 
struction expansions which use address constants which were filled into 
a data control block by a privileged access method routine. 

Writing a Fence-Sitter 

Fence-sitters must be <:onstructed carefully. If a nonprivileged pro- 
gram is using a fence-sitter and the fence-sitter is interrupted, it is 
guite possible that a privileged program will use the fence-sitter dur- 
ing the period of interruption. The fence-sitter must, therefore, be 
reenterable within the task. Programs may be reentered between tasks or 
within a task. The use of a prototype control section C^^SCT) enables 
different tasks to use the same read-only control section. Within a 
task, however, a program is generally made up of one nonprototype con- 
trol section (which may be shared with other tasks) , and one prototype 
control secrtion (which is never shared with other tasks) • 

Inter ruptable service routines, to be reenterable within a task, use 
multiple save areas and dynamically allocated virtual storage (via 
SlTHIIlf) . 

Fence -sitters can use a number of technigues to prevent the destruc- 
tion of data if they are interrupted and reentered. Some fence-sitters 
do not have a PSECT; if they have one, they never modify it. Other 
fence-sitters reguire the calling program to supply working storage; 
still others use GETiAIl to obtain working storage. 

Linkage From Fence-Sitters to Other Routines 

If a fence-sitter routine needs to link to a privileged service rou- 
tine, the fence-sitter uses either a type-1 or a type-2 linkage, depend- 
ing upon the privilege class of the routine that invoked the 
fence-sitter . 
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Deteralninq Feace-Sitter Privilege 

The fence-sitter can determine the privilege of the calling routine 
bj checking the privilege bit in the VFSl contained in field IS1C?F. 
Parameters can also be snpplied bj the calling program to tell the 
fence-sitter what privilege it has. The fence-sitter can also determine 
the privilege of the calling program bj using other information snpplied 
bf the calling program, snch as the data control block (DCB) • 

For example, TSS QSIM is designed as a fence-sitter, and will run in 
the same privilege status as the routine that invokes it. Since it is 
most often invoked bj the problem program, it nsnallf runs in the privi- 
lege of the nser and maf or may not be of the same privilege as the BSIH 
modules that it invokes. All the BSIH modules invoked, except lOfS, are 
privileged routines. Is lOTl is also constructed as a fence-sitter, and 
will take on the privilege status of QSIH whenever it is invoked, type-1 
linkage is always established to invoke HOTE. 

Before establishing linkage to any of the other BSIH modules, it is 
necessary to determine the status of QSIH subsections. QSkE routines 
perform this function with respect to their BS&H counterparts by testing 
the first bit of the VPSl in the ISI. If QSIH is privileged, type-1 
linkage is established, using the address constants defined within the 
data control block. If it is not privileged, type-2 linkage is estab- 
lished via the BITBB SVC. 



VIBTOAL HBHOBY LQCKIHG 

Bationale 

To provide inter-task serialization (that is, the assurance that only 
one task at-a-time can alter a control block) , most shared virtual 
memory control blocks include space for a Lock Byte, commonly known as a 
"*VH Lock"*. Jkny task which has need to alter the block or to read the 
block without interference can *set the lock*, perform its function, and 
"^open the lock"; no other task which observes the lock protocol can 
interfere. 

f he ••test and Set* C^S) instru€:tion is used to set the lock — bit 
(X*80») on indicates "set*. The TS instruction provides inter-processor 
and inter-task serialization and sets the byte to I*FF». The lock may 
be opened by doing: HVI lock,X»00*. 

The TS instruction sets the condition code so that the status of the 
lock, at the instant of the set attempt, may be determined. If the lock 
is found to be set (by another task) , the task wanting to lock must wait 
until the lock is opened. The waiting process must include retry of the 
TS instruction. 

To provide the resident supervisor with information about tasks which 
are waiting for fH Locks, a special use of the "Time Sliire End" (TSBVB) 
supervisor call macro has been defined. This permits adjustment of task 
scheduling as well as detection of excessive waiting time. If a locdc 
appears to be "frozen**, the task (s) waiting on it will be given a task 
program interrupt. 

To provide the task monitor program with information about lock acti- 
vity in a task, a one-byte counter ISIVLKCT and a one-bit flag ISI?LK/ 
ISAVLKH have been defined in the Interrupt Storage Irea (CHAISl) control 
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block. These also provide inforaatioii ttsefml to debugging of lock- 
related problems • 

k sjsteB routine, CZICS, is available and should be msB§. to provide 
release of VI locks in the event of abnoraal terMination of a task, 
lefer to "Releasing Interlocks at Ibend" in Section 4. 

The xxxVLOCK aacros provide a consistent «eans of observing proper VI 
4#ock protocx^l and simplify progriai coding, especially in the case of 
anlti-level and/or chained control blocks. Ill VI Lock processing must 
use these macros to ensure proper protocol. The only exception is a 
small set of Virtual Iccess Method locks which are handled only via 
modules CZCOH and CICOI* 



Overview 

There are six macros in the xxxVLOCK set: CHGVIOCK, CllVLOCl, LOGV- 
LOCK, OPFTLOCK, SIT^FLOCK, and TSTVLOCK. I brief description of each is 
as follows: 

"LOG" generates ii control block in which the other five macros record 
lock status. 

"SET" sets a specified VI Lock and records it in a specified LOG. 

"OPl" opens the ¥M Lock recorded in a specified LOG. 

"CHG" exchanges two LOGS, to facilitate processing of chained control 
blocks with individual locks. 

"TST" interrogates a LOG to determine the status of the recorded VI 
Lock. 

"CLl" opens the 11 Lock recorded in a specified LOG, in a special 

manner related to IBB9D Interlock Release. 

The following definitions apply to this discussion of VI Locks: 

Tree: a set of two related but different control blocks organized 
in two logically --distinct "levels". The first level is one control 
bloG^. The second level is generally a detail expansion of the 
first and may be a single control block but is usually a list or 
chain. The specific address of at least the first member of the 
second level is usually recx>rded in the first level block and pro- 
bably varies over some short period of time. The address of the 
first level is often fixed at system startup or task logon 

List: a set of two or more copies (same layout, different content) 
of a control block which occupy consecutive locations in virtual 
memory. Any one can be referenced given the address of the firs.t, 
the length of each (usually fixed) , and the number of members. , 

Chain: a set of two or more copies of a control block which occupy 
arbitrary locations in virtual memory, where each member contains 
the address of the next member in the logical order. Any one can 
be referenced given the address of the first. The first level of a 
tree may be a mcimber of a chain or a list. The second level of a 
tree usually is a chain or a list. 
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Using the xxxIIbOCK Eacros 

Consider tlie following data structure for illustrating the nse of the 
xxx¥LOCK Bacros* 



lock 

bfte 



nnaber — - 
of EXIHT 
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Figure 9. Saaple Bata Structure for xxxfLOCK iacros 

The on If constant available to the sample program is the address of 
BXBIS. SfsteB BSBCTs are assumed to be available for EXBAS, EXllT, and 
BXBET. 

The objective of the sample program is: to find a particular "class" 
of BXIIT (the second in the example layout) ; to find the last EXBET; and 
to add a new EXBET before the last (due to some priority scheme) . The 
number, but not the order, of EXIVT may be changed by any task. The 
number and order of BXBBT may be changed by any task* 

In the PSECT of a module you may code the following VM I.ock Anchor: 



LBIS 


LOGVLOCK , 


IIHT 


LOGVLOCl , 


LBBTl 


LOGVLOCK , 


LBET2 


LOGVLOCK , 


IBETA 


LOGVLOCK , 



lECOlB BXBIS .BISLK 
IBCOIB EXIHT.IIITLK 
RECOIB BXBBT. BETLK "l" 
lECOBB EXBET. BETLK "a" 
lECOBB EXBET. BETLK "IB1« 
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Fick. ap the address of EXBIS^ providing addressability bf the DSECT, 
and then: 

SBIS SETVLOCE BISIK^LBIS LOCK BIB&S 

lext, pick ttp the address of the first EIIIT froa BASIMT. 

Ifter providing addressability for EXIIf, you can DEOP the addressabili- 
ty for^EXBIS (not required for the OPlfLOCK later). 

QIIT EQO * 

Test EXIIT to find out if it is the one yo»i want. If it is, go to OBIS. 
If it is noty check BASCBT to see if there are any aore IXIlTs* If 
there are no sore EIIlTs, go to HIT. 

To check the next EXIIT, imcreaeat your EXIIT base register by the 
leagth of BXINT, and go to QliT. 



HIT OPlfLOCK LBIS 

Here, you liave ruii omt of FUST, r^o you cam log a SfSEEp or whateYer, 
and end the? program. 



Issiiaing ycm have foimd the EXIIT you want, yon can: 

OBIS SlTfLOCK IMTLK|,LIiT LOCK DESI1B0 IXIIT 
OPIVI.OCK LBIS Of LOCK EXBIS 

Then pick up the address of the first EXDET froa IITFBT and DROP addres- 
sability for EXIIT « Wow yon mast setup addressability for IXDIT, and 

SDET SETfLOCK DBTLK^LDETI FIRST (^B^) 

OPifLOCE Llif lilLOCl IIIIT 

QBET EQU * 

lott are now sitting on an C"B»% »♦£*, "I«»| EX'BET,. looking for the last 
EXBIT. Check DETIXT and, if it is zero^ you are on the last {"«I") ,. so 
yon go to IkDET* 

Otherwise l**B''^«^C'*j ^ needing to go to the next BXDlTp. you load {"C",^I") 
DITIXT into your KXBET base register, and 

CLEfLOCK LDET2 PlIOl CO,"B»} 

CHGfLOCK LDET1^LI)ET2 BXCH&IGE (»«B»/0,"C*»/S) 

SETVLOCK DETLX^LDETI lEXT (^C'*,**k^) 

Then go to QDIT 



IDET EQO 



Ton are now sitting on 'the last f*I**) SXBBT^ needing to aid a new EXDIT 
before this one. Find a slot to build a new IXDET and initialize it to 
0. 
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low is the tiae to change the current f"!*) DETPEE,. 

L PIEEEG^DETPRE m «C« FBOK "^11 
ST iEWBIS^DETPEE i lit IlfO ^I» 

Then load |0ur BXDET base froo PIEBIG to cover the previous f«C") ElBET 
and 

L MXTHEG^DEflXT i wi»» PHOB "C« 
ST lEMBIS^DlTlIT m lEi IITO »»C^ 

low you are readf to fill in the new IIDIT; load four EX0BT base froa 
lEWBAS^ and 

SETfLOCE DlfLK„.LD^OTI IBl 
OPlfXOCl LD1T1 IFXT» ("!«) 

OPlfLOCl LDET2 PHIOfi pC*) 

SI! PlEllG,.PEfPSl i «€•» to new 

ST ilTSEG^DETilT m «!" to new 

Fill in the new EXDET yon are on, and 

OPN¥LOCK LDETI lEl 

low ead the prograa,, which should incl'iide: 

TSTILOCI L0ETi,errorDI LOCK 

TSTfLOCI LDET2,error»1 * ilS 

TSTfLOCK L0ET1^error»2 ♦* LEFT 

TSTYIOCK LIiT,errorI *** SET,, 

TSTfLOCE LBIS ^errors **** RBEID 



Your ABEIB Interlock Eelease lontiae shottli iBclmde: 

CLBfLOCK LDETI 

CLBfLOCl 1.DET2 

CLEfLOCK LDETl 

CLBILOCK LIIT 

CLllLOCK LBIS 



f SUPEEVISQH COM llilli^ 1211 'ill 

The systeip re.-uiirce locks are main tai n€f d in a table in the supervisor 
(instead o:^ virtual memory) with a oeneral purpose y^Q/DBQ function. 
This table allow:-; the stioervisor to recover any resources held by a task 
being delett'---;:! -tri'! to maintain reliable sche'iiilin^7 inforBation. 

If these lockF were 3. n virtual memorv and a task abended or loqaed 
off leaving a Iock. set on a system reauire^d resource, the system would 
ha¥e to be relPL^^d^ Deca ose users would be unable to access the reauired 
resource. Mfg , the system would be unable to determine which task was 
holding the lock * 

The implementation is as follows: 

1. A hashed dii! chained dictionary of resource n.aiiies is piaintained 
i . n th '-1 F n d ^ •* r v i s o r • 



m 
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2. Two lacros EiQ and DEQ (refer to the Assembler User Facro 
In struction manual) are provided to interface with the new 
aechanism. The ^NQ function is perforied asynchronously with the 
task. The completion^ successful or otherwise, is posted back to 
th€! issuer in an FCB . 

3. Th€? important virtual tnemory locks use this mechanism ^ — VAM lock 
modules C3C0H and CZCOI; also, FIND, STOM , and ECR. 

4. The module CZAHC posts an ECB specified bv an external interruBt 
code cueued on the task by the resource control module. 

?IM LOCKIIIG 

VAM»s lock modules CZCOH and CZCOI use the ENQ/DFO mechanism. CZCOH 
issues an ENQ using the lock's IKK as the resource name and CZCOI issues 
a DEQ to remove the lock . 

The parameter list for CZCOH allows the caller of CZCOH to recuest a 
return cofie and to request that CZCOH abort the lock reouest if the user 
attempts to attention out of the reouest. The lock type code has had 
the two high order bits (X*80' and X*40») defined to reauest one of the 
above actions. If the bits are zero^ CZCOH processes as before. If the 
bit (XMO*) is a 1, CZCOH returns a code to the caller signifying the 
success of the lock reguest. CZCOH will return one of the following 
codes: 

- lock successfully set 

4 - iiait time expired: register 1 contains 
the taskid of the lock holder 

12 - lock reguest purged before lock was set 

If the 1 bit {X»i40»)is a ^, CZCOH will test for a pending attention 
from th user while waiting for a lock to be successfully set. If an 
attention is detected^ the lock reguest is purged and an 8 code is 
returned to the caller. 

whenever CZCOH returns with a non-zero code the lock reguest has not 
been fulfilled and it is up to the caller to recover from the situation. 

To facilitate the wait-time-exceeded case^ and to oresent to the user 
a standard message with standard inserts, a second entry point has been 
added to CZCOH -- CZC0H2 » If this entry ooint is called with a suitable 
parameter list, CZC0H2 will build and return to the caller a message 
containing the appropriate information to define the unsuccessful lock 
attempt to the user. The parameter list for CZC0H2 is the same as CZCOH 
except that two words have been added to the end of the list. Word 5 
contains the taskid returned by CZCOH when a lock recuest has exceeded 
its wait time. This is assumed to be the taskid of the task holding the 
reguested lock too long. Word 4 is a pointer to a message insert to be 
used for lock type X*1U» calls* It is assumed that this insert explains 
the type of control block the caller is attempting to set. The address 
should point to a character string preceded by a one-byte length. 

The CZCOH 1 parameter list is as follows: 

Register 1 — 3 word list 

word 1 -* address of lock point 

word 2 - address of two or three byte control field 
word 3 - address of DCB or 
word 4 - address of messc ge insert for type 
xntt» calls (reauired) 
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Format of Control Field 

byte 1 - type of access reauested 

C*W« - exclusive access fwrite) 

C»l» - shared access (read) 

byte 2 - control block being locked, and flags 

codes: X»00» -- SDST entry 

X»Oa» - EESTBL 

X»08* - POD 

X*OC» ~ meinber header 

XMO» - page lock 

X» 1t*» - other 

bits and 1 of the code byte are used as flags 

(X^SO') - return with a return code 

1 (X»40*) ~- test for pending attentions 

byte 3 - option flags for a type X»14» call; this 
byte is used only on type X*1il» calls 

bit 0: - system controlled resource 

1 - user controlled system reso-urce 

bit 1: - normal wait required 

1 - lock request is an immediate request; 
do not wait if already locked 

CZC0H1, if requested I. will return one fo the following return codes: 

- successful attempt 

4 ~ wait time exceeded; lock holder's 

taskid is in register 1 
8 - attention detected (only if bit 1 is a 1) 
12 - lock request purged 

The CZC0H2 parameter list is as follows: 

legister 1 — 5 word list 

word 1 - ^address of lock point 

word 2 - address of two byte control field 

word 3 - address of DCB or 

word 4 - address of message insert for code X*1t*» 

word 5 -^ taskid of lock holder 



Format of Control Field 

byte 1 - type of access recuested 

C»W» - exclusive access (write) 
C'P' - shared access (read) 

byte 2 - control block being locked, and flags 

codes: X»00» - SDST entry 

X»Ot»» - EESTBL 

X»08» - POD 

X»OC» - member header 

X» 10» - paae lock 

X»1£|» - other 

bit of the code byte is used as a flag 
(X»30») - do not return; CZCOH" 
will call ABEND 

CZC0H2 will return to the caller the length of the build message in 
register and the address of the message in register 1. 

1*0.2 
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I DIIIMIC SCHEDOIE TABLE TRIISITION 

The ENQ/DEQ meclianisin proirides another scheduling capability to TSS. 
This capability allows a task to be given a dynamic schedule table 

transition as page stealing does, 

A second entry point in CEIKZ {CEIK22) makes the transition and 
updates all reouired system control counts. CEIKZ2 is called with the 
new schedule table level in register and the TSI address in register 
1« CEAKZ2 validates the new levels calculates a second new level if the 
first new level has the prejudice flag on , and updates the task 
dispatchable priority from STEPRIOl and the nuiiber of auanta left by 
calculating the number of guanta used from the old level and subtracting 
that value from the new guanta count. The task is guaranteed at least 
one additional quantum. 

If the task is on the inactive list nothing else is done. If the 
task is on the eligible list a new scheduled start tine is computed and 
the task is reslotted in the eligible list using the new priority and 
scheduled start time. If the task is in the dispatchable list, the task 
is reslotted using the new priority. SYSECB and SYSBTCNT are updated to 
reflect the possible change in STEWIXCl between the old and new schedule 
table levels. 

Currently,, CEANB ^ PULSE SVC,. CHANGE SfC and EHQ/BEQ are the only 

routines using CEAKZ2. 

ENQ/DEQ SCHEDULING 

The E^Q/DEQ mechanism uses the Holding Lock exit in the schedule 
table as its scheduling exit. When a task acguires its first system 
resource (i.e., holding resource count = 1) the ENQ/DBQ module CEABS 
uses the Holding Lock value in the current schedule table entry as the 
next schedule table level for the task. CEAiS saves the task's current 
schedule table index and calls CEAKZ2 to take a dynamic transition to 
the new schedule table level. When the task frees its last system 
resource, CEAES retrieves the saved schedule table index and calls 
CEAKZ2 to return the task to its previous level. 

The EllQ/DEQ module schedules only for resource entities called system 
resources. A system resource is one that is allocated and released 
completely under control of privileged system control , without ever 
returning to non-privileged code. Examples are EESTBL locks, POD locks 
and user table header and entry locks. User controlled resource 
entities are resources whose duration of allocation is controlled from 
the non-privileged code or by user action. Examples are data^t access 
locks, member access locks and page locks, iith these resources, the 
duration of the allocation is usually controlled completely by user 
action - 

The task when waiting for a resource will issue an AWAIT SVC against 
an ECB. This allows the current system AWAIT extension code and 
schedule table value to be used. The current EMQ/DSQ mechanism does not 
use a waiting on lock mechanism: it is not required. 

With SNQ/DEQ, the system considers it an error if a task issues a 
WAIT or TWAIT SVC while holdincf a system resource. This error currently 

only results in a minor syserror,. 
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BBSOPBCB COBTBOI. FACILITIBS 

fSS provides facilities to the systea prograsKer for irontrolling the 
allocation of system resources to users and for keeping records of 
resource usage. 

Thm control and accounting functions apply to the following re- 
sources: CPO tine, terminal time, number of concurrent background 
tasks, amount (in pages) of permanent and temporary public storage, num- 
ber of direct access devices, magnetic tape drives, high speed printers, 
readers and punches, and the number of records read and written by 
BULBIO. 

Accounting Overview 

An overview of the a€»:ounting facility's logic is given below. Be- 
sources are allocated and kept track of by means of several tables (the 
user limits table, the system user table, the active user list table, 
and the task aixrounting table) and several macro instructions and com- 
mands: USAGB, UPDTOSIB, JOII, and BBJOll. USA6B and OPDTOSBB are com- 
mands as well as macro instructions; JOll and BBJOIl are commands only. 
The function of each table used by the accounting facility is summarized 
below. The macro instructions are described in Part 11 or in Assembler 
User Macro Instru<;tions . The JOll and BUOIl commands are described in 
Manager's and Administrator's Guide . The USAGB command is described in 
Command System User's Guide . 

User limits Table (STSOIT) - DSICT CHAUIT 

SfSOLT is a table containing the maximum amounts of resources a user 
is allowed at one time or over a given period. Bepending on the 
resourc^e (CP0 time, 1/0 devices occupied, etc.) , the time may be the 
duration of a task or the duration of some installation-established ac- 
counting period. Initially, when the system is supplied, two sets of 
limits are defined in the table: one set for system programmers and one 
set for user programmers. The limits supplied with the system for each 
of these two sets are summarized in Appendix G. 

When a user is joined to a system, the BATlOl operand of the JOIV 
command determines which set of limits the user has. The set of limits 
is recorded in the user*s entry in the system user table (see below) • 

An installation may change the system -supplied values for either set 
of limits; it may also define and add to the user limits table up to 
seven other sets of limits, which can be identified by additional BATlOl 
keys when JOIV is issued. 

System User Table (SYSPSB) - DSICT CSAUSB 

The primary purpose of SYSUSB is to provide a list of all legal TSS 
users, with their attributes or characteristic's, for reference by system 
routines, it contains an entry (or record) for each user, referred to 
as a user table entry (0TB) • In addition to the user's IB, password, 
privilege class, authority code, etc., each IFTB also contains fields for 
recording accounting data about the user*s resource usage. This data is 
accumulated from the time he is joined to the system till he is guit. 
It holds accounting statistics for resource amounts being used and 
resource products (that is, amounts multiplied by time used) • At JOIW 
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tiae a user's limit rations (£roa SISULT) are also copied into his entrj 
in SYS0SB. 

Active User List table - DSlCf CHJIIUL 

This table contains an entrj (or recori) for everj task and one for 
eacb user vhose clata sets are being shared bf that task. These entries 
are created by a call to the Besource Control Bontine (BCB) CZCIIA. The 
entries are referred to bj task identification (task ID) and user iden- 
tification (user ID). Several entries nay be associated with one task: 
the prinarj entry (based on a user's task ID and user ID) , an entry for 
each shared data set opened by the user (based on the user's task ID and 
the owner's user ID) , and a systes entry based on task ID and the TSS^^* 
*^^ user ID» Each entry contains a tenporary record of a task's use of 
systea resources from the beginning to the end of that task. 

Task Iccounting Table - DSECT CHIICT 

This table is a work area in which a task's resource statistics (per- 
taining to its prinary entry in CHIAOL) are recorded when that task 
coses to an end. This work area is made available to user-written ac- 
counting routines at the end of each task. 

Besource Control Operation 

To get the system started, two entries (two sets of limits) have been 
defined in the user limits table (SISULT) . An installation, however, 
may provide new sets of limits or change existing ones at any time (see 
"Betrieving and Modifying Acrcounting Data Sets" also in this section) . 
When a user is joined to the system, he has an entry (the DTI) created 
for him in the system user table (STSOSE) . At that time, the user's 
limits (from SISDLT) are automatically <x>pied into that UTE. 

As each user issues L0601, the OTE for that user is copied from SIS- 
0SS into a shared virtual storage table, or in cases where another task 
is active for the same user ID, the task is connected to the DTE already 
copied into shared virtual storage. Each task then has several task ID 
entries assigned to it in a se€X>nd virtual storage table, called the ac- 
tive user list (CHAADl) • Thus, the two virtual storage tables, defined 
by DSECTS CHADSE and CHAADL are used to record user ID and task ID ac- 
counting data, respectively. During the execution of a task, the task 
can refer direcrtly to these virtual storage tables and update user ID 
and task resource statistics in those tables without interfering with 
their use by other tasks belonging to the same user. 

Dynamic Accounting 

During task execution, every time a user requires additional re- 
sources, the system checks the amount of needed resourcre plus his 
currently -used amount against the user's limits to make sure he has not 
exceeded them. If they are not exceeded, the resourcres are allocated to 
him and the virtual storage accounting table (defined by CHAUSE and 
CHAAOL) is updated to reflect the additional usage. This process occurs 
whenever external pages are assigned to, or relinguished from, a user's 
VAH data sets, or when devices (such as disks, tapes, printer, and 
reader -punches) are assigned or released. CFD time and connect time are 
not updated dynamically; they are updated only at the end of each task. 

The "time last changed" fields in the user's DTE and in each user 
task's active user list entry are used to calculate the product 
(resource multiplied by tine used) fields in those tables when addition- 
al resources are allocated. 
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Keeping track of resources is accomplished (at LOGOFF and IBIMD) by 
the system accounting subroutine and (dynamically) through use of a call 
to the lesource Control Routine. 

Shared Data Set Accounting 

When a task uses a shared data set belonging to another task, ac- 
counting statistics are recorded in the appropriate entry in the active 
user list based on the user»s task IB and the owner's user ID. These 
accounting statistics remain in this table until an BCl call is made for 
the shared data set. It this time, the accounting statistics pertaining 
to that task's use of the shared data set are used to update the STSUSE. 
The entry in SYSUSE, associated with the user ID for the owner of the 
shared data set, is updated. Thus, if you share your data sets, you 
will be charged for the use of the resources associated with those data 
sets. 

lesource Control loutine (fiCB) , CZCUI 

BCl is used to open the accounting tables, crompare requested resource 
usage with the user's limits, dynamically update the product fields in 
the virtual accounting tables (described by DSICTS CHIUSB and CHIiUL) , 
and release or vacate resources when a task has finished using them. 

When a task goes to LOGOFF or ABBHD, ICl is called to tabulate ac- 
counting data for each user ID and each task or subtask (for example, an 
express batch subtask) , and makes sure all resources used since the last 
allocation have been updated. The task accounting data tabulated by 
this process is: 



1. Temporary page seconds 

2. Permanent page seconds 

3. Private disk seconds 

4. Private tape seconds 

5. Private printer seconds 

6. Private reader/punch seconds 

7. Total number of auxiliary 
storage pages 

8. Total number of TW&ITs 

9. Total number of AWIITs 
10. Total time slice ends 



11. Total page-ins from auxiliary 
storage 

12. Total page-ins from external 
storage 

13. Total page-outs to auxiliary 
storage 

I**. Total page-outs to external 
storage 

15. Maximum pages held on auxiliary 
disk 

16. CPU time 

17. Terminal connect (COIM) time 



CPU time and connect time are updated for conversational tasks. For 
nonconversational tasks, only CPU time is updated; connect time is reset 
to 0. 

The shared virtual storage image of the user table entry should now 
reflect the status of the user's system resources. These updated sta- 
tistics are then recorded in the permanent SlSDSl data set in external 
storage. 

For both conversational tasks and nonconversational tasks or sub- 
tasks, the accounting subroutine branches to a dummy task accounting 
module at CZIGA. Upon entry, this module returns control to the calling 
routine. It is provided as a hook for user-written accounting routines. 
A user can replace the dummy module with his own task accounting 
routine. 

At the time of the call, register 1 contains a pointer to a parameter 
list that contains a pointer to the work area containing the task's ac- 
counting statistics. Users who want to examine this data can establish 
addressability to the work area, by using the DSBCT CHAACT. Signed 
binary values representing each resource are stored in the work area. 
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llien the accomitliig routine returns to the caller r a subsequent ICH 
call is made to remove the appropriate task--oriented entry from the ac- 
tive user list and to close out the user table entrf in shared virtual 
storage* This is done by disconnecting the task from the shared- 
virtual-storage UTE orr if there are no other tasks active for the user, 
by writing the shared-virtual-storage UTE to SYSUSB and freeing the vir- 
tual storage copy . 



IISTALLJkTIQM ICCOPSflllG BOUTIIES 

An installation may establish its ovn accounting routine by writing a 
privileged module, assigning to it the module name CZI6A, and replairlng 
the dummy accounting routine at CZIGI with the installation's module. 



IHPOlTiLHT ICCOUNTIIG COISIDEIITIOIS 

then the installation accounting program receives control from the 
system accounting subroutine, it can write to SYSOUlf, can define (BDEF) , 
open, and close its own accounting data sets, and can perform most sys- 
tem functions. However, the user should be aware that all non-system 
data sets have been released; only selected system data sets remain open 
(for example, SYSUSE, SISCIT, STSOUT, and SYSHILFJ . In addition, the 
user may be restricted in the functions he can perform in an accounting 
routine invoked by IBEHD, depending on the cause of the abnormal end. 

System programmers should be aware that product (resource multiplied 
by time) fields (except for CPU and connect time) accumulated in the 
virtual storage copies of SISUSB (CHIUSB) and CHIAUL are updated as re- 
sources are allocated or through use of the USAGE command or macro in- 
struction. Although those tables are valid as of the last update, the 
work area (defined by DSECT CHAACf) , in which task accounting data is 
accumulated, is updated only at LO^>PF or ABEID. CPU time, connect 
time, and the permanent copy of the product fields, recorded on SISIJSE, 
are updated only at LOGOFF or ABEHB. A system programmer should also be 
aware that if the system is taken through an HPS and OPBTOSEl sequence, 
resource counts are updated, but the product fields are reset to zero. 
Thus, before executing such a seguenc^e, installations should save the 
existing accounting data for later processing. 

Accounting by User or Task IP 

Installation accounting routines can associate accounting information 
with a user ID or a task ID. If the user ID is chosen, the already 
opened virtual copy of the SfSUSE data set can be examined. The ability 
to address the user table entry can be established from the address of 
the UTE found in the task common field TCHVLU. The DSECT CHAUSE can 
then be used to extract information, and the installation accounting 
routine can perform any desired arithmetic (all entries in the table 
contain signed binary data) . Accounting by task ID can be accomplished 
by examining the work area, defined by the DSECT CHAACT, in which task 
statistics are recorded at the end of each task's processing. 

Accounting bv Charge lumber 

If an accounting routine desires to accumulate billings based on 
charge numbers, it should be aware that TSS accepts all charge numbers 
without validating them. If a charge number is defaulted at LOGO!, the 
charge number assigned to a user when he is joined to the system is used 
for that task's accounting at LOGOFF or ABEID. It is the responsibility 
of the installation's ac:counting routine to verify charge numbers. If 
the accounting routine finds a charge number is invalid, it can use the 
user ID. 

nil 



Accoaating on a Project Basis 

k user who vlshes to be charged separatelf bf project »af do this bf 
being Joiaed to the sfstem under separate user IBs. la order for hi« to 
haire access to his data under separate user IDs, he must use the PSBHIf 
and SHJlBl comaands for his various IDs» 



DISPLIIIIG IID ILflllMG ICCOBITIMG STITISTICS 

If at anf time during a task a user wants to know how manj resources 
are assigned to his user ID, or what his resource limits are, he can 
issue a USIGE command or macro instruction to display them on his SISOUT 
device. Remember these are user statistics rather than task statistics, 
except for CPU and COHM time current fields. The USAGE command or macro 
instruction also updates the product fields in the virtual storage ac- 
counting tables (CHAUSE and CHJIJIUI.) . I user ID option is available with 
USAGE for system programmers, managers, or administrators, which dis- 
plays the usage statistics for any user Joined to the system. Similar- 
ly, a ■BESET* option can be used by managers and administrators to reset 
a user's product fields to zero (see the description of the USAGE com- 
mand in the Manager ■s and Administrator's Gnide l . 

Managers and administrators can use the BSJOIH command to change the 
user's limits, increasing his resources (see BEJOII in the Manager's and 
Administrator's Guide 1 . 

Mote : If a user's resource usage were to change when the system ac- 
counting facility was not in operation, his accounting statistics would 
not be updated (for example, if an BPS and C¥¥ command sequence was per- 
formed or in the event of system failure) . In such cases, an authori- 
ty system programmer should employ the UPDTOSBB command or macro in- 
struction to update the resource count statistics in the user table for 
all users joined to the system (the product fields in the UTE are not 
updated at this time) . 

RETBIEflHG AID MODIFYIIG SYSTEM ACCOUITIIG DATA SETS 

To assist users interested in writing accounting routines and estab- 
lishing their own resource limits, information on SISULT and SfSUSE is 
summarized below. The DSECTs for the system accounting tables (CHAULT, 
CHAUSE, CHAAUL, and CHAACT) can be £ound in the ASMMAC system library. 
Appendix G shows the resource limits supplied by IBM. 

SXSULT characteristics: 

• fISAM member of TSS**»**.S¥SLIB. 

• Each record in the table, specifying the limits for a specific user 
or type of user, is 6*1 bytes long. 

• The hexadecimal key, in the first four bytes, is in the range 1-9, 
inclusive. 

• DSECT CHAULT. 

• All limit fields contain a fullword of signed binary data. 

• USAGE documentation describes the general contents of each field. 

• Although the JOIH cx>mmand indicates that there are only two availa- 
ble sets of limits in the user limit table (SISULT) , additional sets 
may be added to the system (or existing limits changed) by modifying 
SYSULT. This can be done by issuing the MODIFY command using the 
hexadecimal option. For example: 
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Oser ; modify syslib (0} (sysult) , rli:ecl=64^kefla=0,rkp=0,recfB=f 

System : Either prompts user for the hezadecinal input data or 
unlocks the terminal keyboard. 

Oser : Enters the new set of limits in the form : 

xXOOOOOOO3OOOOOOelOOOO232b6OOOO4e20OOOO 100000000c- 
8000 000020000 000 20000000200000002%e 

For additional information on the lOBIFI crommand^ see Command System 
Oser 's Guide . 

SYSUSE characteristics: 

• Each user ID record (that is, a OTE) is 256 bytes long. 

• Has an EBCDIC key. 

• DSECf CaAOSE. 

• 111 accumulation and product fields contain fullword signed binary 
data • 

CREATIHG YOOR QWH PlIVILEGE CL&SSES 

lou may assign one, or a combination of several, predefined privilege 
classes (see Appendix H) to a user at the time you join the user to the 
system. In addition, you can create additional privilege classes, using 
any of the remaining (undefined) alphabetic characters. To accomplish 
this, you can use the CLOP macro instruction during system generation to 
introduce a new privilege class to the system; this records the privi- 
lege class in task common (DSECT CHATCIJ as a valid privilege class. 

Any routines you want associated with the newly defined privilege 
class must be coded to examine the appropriate privilege class bits in 
the four class bytes in task common. 

At JO II time, the privilege class you have defined can be assigned to 
users of your choice; they may then use the set of routines you have 
made available to them. 

BSTABLISHDiS PRIfllSGED IMf ERRgPf IQBI SERflCIHG ROOTItfES 

for normal returns from a privileged interruption servicing routine, 
execution resumes at the next seguential instruction following the point 
of interruption, just as it would from a nonprivileged interruption rou- 
tine (see "Processing an Interruption" in Assembler Programmer's Guide! • 
However, if a privileged interruption servicing routine wants to modify 
the return address at which control is to resume, it must use a differ- 
ent process than that used by nonprivileged routines.^ Rather than modi- 
fying the old VPSl in the area pointed to by register 0, as done by non- 
privileged routines, the privileged interruption servicing routine must 
modify the instruction address in the old TPSI at location ISA10P 
(X»730*) in the interrup storage area (ISAJ - Control then passes from 
the interruption servicing routine to the newly specified address, rath- 
er than to the next seguential instruction. 

SCHSDOLIHG TIKE BY A SfSfEK TABLE 

CPU time in TSS is scheduled by means of a system table (the schedule 
table, CHASTE) that permanently resides in main storage as a system con- 
trol block. The supervisor refers to this table when schedulling tasks. 



i|6 



botk at task initiatioE and dttring execmtioE of the task, to deteraiae 
when next to schedule the task and for what amount of CPU tiae. The 
scheduling table may contain as many as 256 scheduling levels, called 
schedule table entries (Sf 1) . 

User priority and task type (that is, conversational or batch) deter- 
mine a value that is assigned to the STl field of the task's TSI; that 
value then determines the task's initial scheduling parameters. Once a 
task has been initiated, the supervisor may move a task to another lev- 
el, as for example, when a task is switched from conversational to batch 
mode. Levels are also adjusted for tasks that are to be I/0-bound or 
execute- bound. 

the system programmer may also change the scheduling of a task. The 
POLSE macro instruction permits you to change the STE level of a task to 
another pre-set "pulse level" that is associated with the current level. 
The CHANGE macro instruction permits you to change the task's level to a 
level that you specify. The PULSE macro instruction is unrestricted; 
CHANGE is restricted to privileged routines. 

The PRESENT macro instruction permits you to determine the schedule 
level of a task; it is unrestricted. 

The values in the scheduling table are established as a function of 
system generation and maintenance. Full information on the system table 
is provided in System Control Blocks . System Logic Summary explains how 
the supervisor uses this table for scheduling. To alter table values, 
consult System Generation and Maintenance . 

DEADLINE DISPATCHSB 

ACTIVE LIST 0RDEBIN6 

The active list is subdivided into the dispatchable list and the eli- 
gible list. The dispatchable list consists of tasks which are in main 
storage competing for CPU time. The eligible list consists of tasks 
which are ready to execute but have not yet been brought into main 
storage. 

Tasks on the dispatchable list are ordered by the priority schedule 
table field (STEPRIOR) with the smallest priority number first. Tasks 
with the same priority number are ordered so that paging-bound tasks are 
ahead of execute-bound tasks. Paging-bound tasks are those which, in 
one quantum, cause more page relocation exceptions than the amount spec- 
ified in the maximum page relocation exceptions schedule table field 
(STEMEQ) . Tasks are initially placed between paging-bound and execute- 
bound tasks having the same priority number. At the end of each quan- 
tum, a task is reclassified as paging-bound or execute-bound and placed 
after all other tasks of the same priority number and classification - 

Tasks on the eligible list are also ordered by priority (STEPRIOR) 
with the smallest priority number first. Tasks with the same priority 
number are ordered by SST (Scheduled Start Time) with tasks furthest 
behind scnedule (i.e., lowest SST) first. 

Because the dispatchable list is now ordered by priority, greater 
care must now be taken in selecting schedule table priority values. It 
is now possible for a task with a small priority number to completely 
dominate a CPU and effectively lock out other tasks for long periods of 
time. Greater emphasis should now be placed on the delta to run sched- 
ule table field (STEDELTA) for controlling the eligible list order. 

The following diagram schematically shows the active list ordering 
for a schedule table with three priority numbers. 
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f SCHEDULE TABLE 

I The Schedule Table header has an entry point CHBSTH; the table is 64 

I bytes aad includes 12 for installation use and 21 that are reserved. 

I All priority fields (STEPRIOR) have been set to X»80«« The delta to run 

I fields (STEDBLTA) have been adjusted to Maintain the proper ordering of 

I the eligible list. 
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I CPO/lPO SCHIBULIMG 

The dispatcher (CSIKD) searckes the dispatchable list fzroQ the top 
(highest priority task) to find a task that is ready for execution ii If 
a ready task is not found, the dispatcher will either exit to the vait 
state or the gueue scanner depending on whether or not any supervisor 
vork exists. If a ready task is found and more than one processor 
exists, the dispatchable list search continues for another ready task 
that has an expired deadline dispatch tine (see the RTTCTL macro in- 
struction description) • If a second ready task is found and the other 
processor is running a lover priority task, the other processor is sig- 
naled to reschedule its executing task and inarch the dispatchable list. 
The first ready task found is then set in execution. 



I fiEAl TIEE TISK ILAG 

I The time slice end processor (CIJIKT) vill keep all of the task*s 

I pages in real storage if the real time task flag (TSIETT) is on. This 

I flag is turned on and off by the ITTCTL macro instruction. To prevent 

I excessive time slice ends for maximum pages alloved, page stealing 

I should be turned on in the schedule table levels for tasks that use the 

I ITTCTI. macro instruction. 



ADDBBSSIHG AM I/O BBVICE 

The initiation of a virtual I/O operation does not require the use of 
the interruption storage area in the way the initiation of a real I/O 
operation requires the use of the prefixed storage area. Virtual chan- 
nel progreuis are constructed using I/O request control block (lOlCB) and 
channel command words that are similar to real CCWs (see the discussion 
of lOCAL) . All I/O operations in a task need not use lORCB channel com- 
mand sequences, thoughit Some I/O operations, such as Virtual Access 
Method (fAM) operations, are performed by using two Supervisor Call in- 
structions (see the descriptions of the PGOOT and SBTXP macro instruc- 
tions) that take advantage of the characteristics of the address 
translator. 

Because most I/O devices attached to the system have more than one 
path to storage, these devices have multiple real addresses. The super- 
visor's pathfinding program selects the address to be used^k To distin- 
guish an I/O device from the path (hardware address) used to gain access 
to it, each device attached to the system is given a unique number, 
called the symbolic device address. The assignment of symbolic device 
numbers is unique at each installation. 

In addition to the symbolic device address, some I/O operations re- 
quire the use of a relative page number. The relative page number is a 
IS-bit quantity allowing a device to have 65,536 pages, for certain I/O 
operations (for example, P60UT) , each device is organized into pages. 
Since each page is 4096 bytes, the position of a given page on all 
devices of the same type can be determined. Thus, page 136 begins at 
the same cylinder, track, and record address for all IBM 3350s. In oth- 
er words, given a relative page number and a device type, it is always 
possible to figure out where, on that device, the page can be found. 

The system symbolic device address and the relative page number make 
up the external page address; they identify the location of a page on 
external storage. 
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IflMEKEEPING F&CILIflES 

The tiae-sharing system maintains inforaation about several catego- 
ries of elapsed time. Timekeeping facilities accumulate statistics that 
can be used for accounting purposes and for monitoring system and pro- 
gram performance. Oser programmers can set a time that measures task 
execution time or elapsed calendar time* System programmers can measure 
time slices and time intervals during which they may want the CPO, or a 
task, to be in the wait state. The TSS timekeeping facilities are com- 
posed of time cells and the macro instructions that set and read those 
cells. 

TIME Cm.LS 

Time cells are used by TSS to store information about elapsed time, 
estimated time, and related data- The relationships of the principal 
timekeeping cells (or fields) are described briefly below under ■•Time- 
keeping Operation." 

Categories of Time 

The information in the time cells provides the system with the two 
basic types of timekeeping statistics maintained by TSS: task time and 
realtime. In addition, CPO time is maintained as a part of real-time 
maintenance (see "lealtime Maintenance") . Bealtime is the actual time 
(in microseconds) that has elapsed since March 1, 1900; from that start- 
ing date every year divisable by four is a leap year (366 days) . 

Timekeeping Operation 

The time-slice allocated for a task is specified in its current 
schedule table entry. Each time-slice is composed of one or more guan- 
ta. The number of guanta and the number of microseconds in each guanta 
are specified in the current schedule table entry. When a task is 
rescheduled and at the end of each quantum, the length of the next quan- 
tum is stored in XTSLTS and XTSCTI. 

If a task is interrupted, for any reason, before the end of its 
allotted time, the value of the cpu timer at the time of the interrup- 
tion is recorded in PSATSJi and XTSCTI, to account for the remaining time 
before the original task is to be time-sliced. 

When the task is redispatched to complete its time slice, the remain- 
ing time available to that task (previously recorded in XTSCTI) is moved 
back into the cpu timer (resetting the clock) . The cpu timer is again 
decremented by the hardware until that task's remaining time is used up, 
and the task is time-slice-ended by the systemi^ 

Whenever an interruption occurs during task execution, the task's 
timers, XTS0TI and XTSATI, are updated. &ny remaining time (in XTSCTI) , 
allotted to the task's time slice, is subtracted from its original al- 
lotment (in XTSLTS) to determine the elapsed time used by the task be- 
fore the interruption. This elapsed time is added to the task's accumu- 
lated CPU-time cell (XTSITI) and, if a task time interruption has been 
established for the task, the elapsed time is subtracted from the XTSUTI 
field; see "Setting the Interval Timer." 

Setting the Interval Timer 

If no task time intervals have been established by programmers to 
generate interruptions at specific times, the time indicated in the cpu 
timer, when each new dispatch occurs, is the time from a task's XTSCTI 
field (the time remaining in that task's time slice). If, however, task 
time intervals have been established, whenever an interruption occurs in 
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the sfsteB^ the cpu tlser field is reset with the shortest period of 
tise after which the sjstea is to generate another interruption* Thus, 
the c^n tiser is reset with the shorter internal contained in ITSCTI 
(tiae rewaining in the tine slice of the next task to be dispatched) , or 
ITSPTI (progranned task-tiwe interval after which an interruption is to 
be generated) • 

If the shorter time interval was found in If SUTI (indicating that a 
task tine interval will expire before normal tine-slice-end) ^ that task 
tine interval replaces that task's tine slice in ITSCTI. The task's 
accumulated cpu tine cell (ITSUTI) is incremented by the time used this 
time-slice (ITSLTS-IfSCTI) and ITS0!ri is decremented by this value. The 
new ITSUTI is placed in ITSLTS and ITSCTI. The task is then redis- 
patched until the new time in the cpu timer expires. When the task is 
rescheduled after the interruption from the task time interval^ the 
schedule table time-slice allotment is again used to initialize ITSCTI 
and ITSLTS; this reestablishes a normal time-slice interval for the 
task. 

11AI.TIH1 lAIVTllIVCE 

lealtime for the entire system is maintained in the TOB C^i^^ of Day) 
clock. Bealtime intervals can be set by programmers. Ifter a 
programmer-defined interval elapses, a system-generated interruption 
occurs to inform the programmer that the time has elapsed. Realtime 
interrupt values are maintained in the ITITIHl field in the real-time 
interruption-pending gueue in the resident supervisor (DSICT CHIITI) . 

ITITIHl is a doubleword in the realtime interruption-pending gueue 
that is maintained in the resident supervisor. Realtime intervals can 
be established in RTITIHB by issuing the SITTIIBR or SITTR macro in- 
struction. Unother user macro instruction, STIMEB, will indicate an 
interval in one of a task's eight realtime software clocks; these inter- 
vals are eventually transmitted to RTITIHl from these clocks, when the 
system issues SETTl. 

TkSK THE IIIIITEIIICI 

Task time statistics are maintained in each task's extended task sta- 
tus index (ITSI) , which includes these time cells: ITSCTI, ITSLTS, 
ITSITI, and ITS0TI. 

ITSCTI is a doubleword that indicates the length of time in a task's 
time slice when the task is initially dispatched. If the task 
is interrupted before time-slice end, this time cell contains 
an indication of time remaining in the task's time slice. The 
time is maintained as microseconds 

ITSLTS is a doubleword that contains a value representing a task's 
total remaining time-slice allotment whenever it is resche- 
duled. The value remains constant while the task is executing; 
it is reset whenever the task is re-scheduled. This time is 
maintained as microseconds. 

ITSATI is a doubleword that contains a value representing accumulated 
task CPU time, up to the time of the task's last interruption. 
It is calculated as the running sum of ITSLTS minus ITSCTI, 
then added to what's already in ITSITI. ITS ATI is maintained 
in microseconds. 

ITSUTI is a doubleword that contains a value representing a task-time 
interval after which a task's execution is to be interrupted. 
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This field is set hj programmers to monitor executioa of their 
programs, fhe time is maintained in microseconds* 

fllEKEEFIlG lACRO IMSTIUCTIOIS 

System-defined macro instructions can be ased to set and read time 
cells. Some of these macro instructions (discussed below) are available 
to the user programmer; others onlf to the system programmer. STIEEE, 
f TIMER ^ EBCDTIlEy SIS^ and STEC are meant for use by the user programm- 
er; they are described in Assembler Pser Macro Instructions : the system 
programmer's macro instructions are described in Part 2. 

Both task time and realtime intervals can be established by using 
system-supplied macro instructions. When these programmed time inter- 
vals elapse, the system generates interruptions that tell programmers 
the time expired. 

User programmers can issue the STIMBR macro instruction to establish 
as many as eight concurrent realtime intervals and eight concurrent task 
time intervals r all of which are recorded in a table in the task monitor 
(the table has 16 software clocks for each user) . Is each interval 
elapses, control is returned to the user^s program. Although STIIBH 
sets these 16 software clocks, it is the inner system macro instructions 
that place these clock values in the appropriate system time cells. 
Thus, the system macro instruction SBTTO places task intervals into 
ITSOTI; SETTR (from virtual storage) and SETTIMBR (from resident 
storage) place realtime intervals into RTITIHE in the realtime interval 
table (DSECT CHARTI) in the resident supervisor. User programmers can 
also use the SIR and STEC macro instrucrtions to establish these task 
time or realtime intervals. 

The user macro instruction TTIMBR can be used to test any of the 16 
software-timer intervals previously set by a programmer. Bata returned 
to the programmer indicates either the time remaining in the interval 
timer he is testing, or that the time has expired. 

The TSEID system macro instruction, which causes a task to be placed 
in the delay state, sets a realtime interval, after which the task will 
be redispatched if no other interruption occurs. This realtime interval 
is egual to a system -defined value, known as ■•delay time," recorded in 
the system table field STSDLT. The system issues SBTTIHER to place this 
interval in RTITIHE; the CAICL system macro instruction can be used to 
cancel an interval established by SBTTIMER. 

Reading System Time 

The realtime setting that indicates the current instant in microsec- 
onds can be determined by issuing the REDTIM system macro instruction or 
the EBCDTIME user macro instruction. 

REDTIM causes the TOD clock to be converted to microseconds and added 
to SYSYMD and SYSTOD; it causes the resulting double-precrLsion fixed- 
point number to be returned in registers and 1. This is the number of 
elapsed microseconds since March 1, 1900. 

EBCDTIME allows users to specify the format in which they want the 
realtime returned to them as: years, months, days, hours, minutes, 
seconds, or tenths or hundredths of seconds. 

The system macro instruction XTRXTS extracts the values set in the 
time cells: 

XTSUTI (explained above under "Task Time Maintenance.") 
XTSATI (explained above under "Task Time Maintenance.") 
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XTSSTI (a field indicating the estimated run time for a task. It 
must be set using the SlfXfS system macro instruction i^) 

Inotker system macro instruction^ IflTl, extracts a task's accumu- 
lated CPU time^ in milliseconds. 

I GBMERALIZED fEACE FACILITY 

The Generalized Trace Facility (GTF) allows hardware and software 
maintenance personnel to dynamically record hardware and software 
events. 

Using GTF^ personnel can record ^ for later analysis, all interrupts 
from a particular device or group of devices, the S¥Cs and/or program 
checks caused by a specific task or all tasks, or entries into RTAMs 
device modules for a particular device or group of devices or network 
addresses. 

If the interrupt rate is too high for ordinary recording, or if only 
the interrupts for a particular event are wanted. The user can dynamic- 
ally set up a circular log in the supervisor and after the event has oc- 
curred, have the log returned to the task and displayed. 

On a high interrupt rate device like the 2305 drum, or attempting to 
trace all disk I/O with 100 tasks running, no attempt should be made to 
write all the trace records to a data set, because not only will this 
degrade performance considerably, but it may cause a system failure due 
to insufficient storage; although GTF will automatically turn off a 
trace if there is insufficient space for a recording block, it is possi- 
ble to satisfy GTF requests and then have a condition wherein there is 
not enough space to satsify the next system request. 

Once a trace is started, it can be ended in one of four ways: 

1. the user issues a command to end the trace. 

2- the task being traced abends. 

3. the trace owner's task abends or logs off. 

4. not enough storage exists to allocate a trace block. 

OPERATION OF THE GTF FACILITI 

The system programmer or maintenance person enters the GTF command 
specifying the wanted options and a data set name to store the trace 
records. There is a limit of 255 concurrent GTF regeusts for the system 
and only one GTF can be active against a resource at any one time. Two 
or more GTF requests against the same SDA, for I/O, are not allowed. 

The GTF module, CSMCA , validates the options, defines and opens the 

output data set, if one has been requested, SIEs for the trace external 

interrupt, and issues the trace SWC to the supervisor to activate the 
trace. 

The supervisor GTF module, CEDTRACE, validates the trace request 
input and asssigns a trace ID for the request. CEBTRACE sets the trace 
flags in the control blocks associated with the resource to be traced, 
allocates and builds the trace blocks and returns a positive response to 
the task . 

As each trace block is filled, the supervisor will queue the block on 
the task as an external interrupt using the interrupt code specified in 
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I the trace request- The GTF external interrupt routine will receive con- 
I trol and writes the block into the output data set. Bach block from the 
I supervisor has a trace ID and a sequence number in it* There are also 
I flags set in the header specifying the trace status and if ended^ the 
I reason for ending. The GTF moduele does not consider the tracae ended 
I until receipt of the stopped flag from the supervisor. 



f GTF BLOCK AMD lECOSD FORMAT 

The G!i!F block built by the supervisor is 2048 bytes in length and 
contains a 32 byte header. The first 16 bytes are used as the MCB head- 
er when the block is shipped to the task. The next 16 bytes are the 
trace block header and contain pointers to the firsts next and last 
entry position within the block. Following the pointers is one byte of 
flags, a one byte trace ID and a half word block sequence number. 

Each GTF entry within a block is a fixed length of 48 bytes. The 
first 16 bytes of an entry are a header supplied by the supervisor trace 
module. The header contains a time stamp , CPU address , record length, 
AID and FID bytes, and an event ID. The remaining 32 bytes are trace 
dependent. 

For a more detailed description of the trace block, see DSECT CHATRAC 

The assigned event IDs are as follows: 

System fide Event IDS 

X*0018" - external interrupt event 

X»0 020» - S¥C interrupt event 

X«0 023« - program check interrupt event 

X»0 038» - I/O interrupt event 

X«0 19C« - SIO event 

X«0 19D" - TIO event 

X«0 191« - HIO event 

RTAM event IDs 

X«8 001» - PIU read completion 
X»8 002« - PIU write completion 
X»3 003« - RTAM module entry 

Task event IDs 

X«4 000» - task RTAH interrupt 

X*4018» - task external interrupt 

X»4 028* - task extended program interrupt 

X»4 03a» - task I/O interrupt entry 



TIMS COyVEBSIOy BOUTINS 

A number of privileged conversion routines are provided to enable you 
to convert time data, in any of several formats, into a form you can use 
with the macro instructions SETTH and SETTU. Two types of conversions 
are performed: type-T, used for operations with the SETTD macro in- 
struction, yields a 32-bit Binary time interval in microseconds; type-B, 
used for operations with the SETTl macro instruction, yields a 64-bit 
binary time interval in microseconds elapsed since Earch 1, 1900 (see 
"Timekeeping") - Two different forms of input data may be used for type- 
T conversion (0 and 1); six forms (0~5) may be used for type-S. Figure 
to suffiiiarizes the different input forms. 
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I i " " ' ■ ^ 

(Input Data Code| Input Fora 

1 

(Time interval in hours (h) , minutes (a), seconds (s) ^ 
I tenths It), and hundredths (h) of seconds 5 eight BCD 
I characters : hhaiissth 
I 
I 

1 I fine interval in milliseconds; 32-bit binary number 

I 
I 

2 I Time of day in hours (h) , minutes (m) ^ seconds (s) , 
(tenths (t) ^ and hundredths (h) of seconds; eight BCD 
I characters : hhmmssth 
I 
I 

3 I Day of week; four left- justified BCD characters: 
IMONDr !rOSS, WEDH , THOB,. FEID, SkTU , SOND 
I 
I 

4 I Day of month; two left- justified BCD characters: 
100 through 31 
I 
I 

5 [Day of year; eight left- justified packed decimal 
I characters : OOy yddd-t- 

I I ^ 

Figure 10. Input formats accepted by the time conversion routine 

IJ0 use the time conversion routine ^ you must put a pointer to a pa- 
rameter list in register 1, the return address in register 14^ and the 
address of the time conversion routine in register 15. It looks like 
this: 





LA 


I^PABAE 


POUTER TO PABAEETER LIST III 


m 






BBGISTEB 1 




L 


15^=f(C2;CJXA) 


ADD BESS OF COHVERSIOH BOUTIHE 




BASE 


14,15 


GO THERE 




BITOBN 






PIMM 


DC 


cn» 


FORM OF IMPOT DATA - 0,1,2,3,4, 


m 






OR 5 




DC 


c«i?« 


TYPE OF CONfERSIOM - T OR B 




DC 


H»0« 


HOT USED 




DC 


D'DATI* 


IITPOT DATA PLACED HERE - RESULTS 


m 






FOITHD HERB 



After completing the reguested conversion, the time conversion rou- 
tine returns control to the address found in register 1^. The results 
are placed, right-aligned, in the second and third words of the parame- 
ter list. 

Note: The SETTO macro instruction expects a time value in milliseconds; 
if you use the time conversion routine to get a time interval (type-T) , 
you must divide the result by 1000 to convert it to milliseconds. 

Figure 11 lists the meaning of the results obtained from the various 
conver si ons . 
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IComrerslonl 



Besult 



TO 
Tl 
10 

Bl 

R2 
13 
14 
15 



I Tine interval ia aicrosecoEds 

I 

I Tine interval in microseconds 

r 

I Current tine -•• input tine interval in nicroseconds 
Ifron March 1, 1900 

I 

I Current tine + input time interval in nicroseconds 

Ifron Harch t, 1900 



I 

I Next occurrence of input tine in microseconds from 

I March %, 1900 

I 

I Next occurrence of daf of week in microseconds from 

IMarch 1, 1900 

I 

(Next occurrence of day of month in nicroseconds from 

IMarch t, 1900 

1 

(Next occurrence of day of year in nicroseconds from 
IMarch 1^ 1900 

I 1 ^ 

Figure !!• lesults of tine conversion 



BfALPATIMG SISTEi STATISTICAL lECQlDIirG FIELDS 

The internal relatidnships that characterize the operation of TSS 
systen prograns and user load are difficult to evaluate ^ To help in an 
evaluation of these relationships, data pertaining to the systen and in- 
dividual tasks are dynanically naintained by TSS. These data include, 
anong others, paging counts, real nenory utilization, software queue 
processor tines, CPU utilization, and scheduling counters. These data 
indicate, anong other things, the CPU norkload, I/O load balancing, 
schedule table efficiency, and individual task loads. 

Two classes of statistics are collected; gloval system wide informa- 
tion and local task oriented datai^ These statistics are recorded as the 
systen is running in fields located in various systen tables and 
nodules^ Many of the statistics are recorded in the system status table 
(CHBSST) in nain storage. Additional statistics are dynanically nain- 
tained in the fields indicated in three dsects; CHAPXS, CHAST?, and 
CHATSX. 

Analysis of System Status Statistics 

The statistics, naintained dynanically by the systen, are available 
to the system progranner through use of the statistics sanpling macro 
instruction SAMPLE. Execution of this nacro instruction causes statist- 
ical data to be collected and recorded in the virtual storage page in 
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which SIMPLE is issued* Sfstem prograaaers can then write their own 
data analfsis prograas to evaluate the data. Proper analysis allow sfs- 
tea nanagers and prograniiers to eiraluate the workloads being processed 
at their installation in relation to the TSS environnent* 

Once statistics haire been analyzed, the systeiD programaer can rein- 
itialize statistical data fields in the sjstea to zero by issuing the 
ZIBOSST aacro instruction. Subseguent djnaaic recording of statistics 
will reflect the sfstea's perforaance since the tine at which ZBBOSST 
was issued rather than since Startup. 



ADJOSTIHG ASSEHBLBR COIISTAMTS 

The f SS Asseabler noraally secures working space for internal use and 
for producing output inforaation. Occasionally, source prograas cause 
an overflow of one or aore of these work areas. This occurs only when 
an exceptionally large prograa (for ezaaple, an application prograaaer*s 
own language-processing prograa) is being asseabled. The syabols asso- 
ciated with six of these work areas have been defined as entry points to 
allow O and P authority prograaaers to alter (via use of ¥SS) the size 
of these work areas when such a prograa is asseabled. Thus, the full- 
word constants at these entry points aay be altered prior to an asseably 
to increase sizes of the work areas for which the asseabler will issue 
6BTHA11 aacro instructions. 

The constants aust not be altered once an asseably has started; in 
such cases, the asseabler *s virtual storage allocation routine will 
issue a coapletion code 1 ABE9D when it detects an atteapt to free aore 
work area than was assigned by GETHJklB. The fullword constants, the 
work areas to which they apply, and several possible causes for their 
being overflowed are indicated in Figure 12. 

CAfJTIOB : Since these constants reside in public, read-only code, they 
aust not be altered if any other user is asseabling. 



ALTEBIHG COBSTIBTS 

ihen an asseably is terainated because of work area overflows, the 
diagnostic aessage issued by the asseabler naaes the work area that 
overflowed. The authorized prograaaer can then use a SET coaaand to al- 
ter the constant associated with the naaed work area, for exaaple, if a 
diagnostic aessage indicates the PHD work area overflowed, the prograaa- 
er aight issue: 

SET CBfPED. (,i|)=4 

This would increase froa two to four the nuaber of pages that would 
be added to the nuaber of text pages divided by eight. 



ESTIHATIHG WOBK ABEA STOBIGE REQOIBEIEMTS 

A knowledge of PHD and ISB control block layouts and the sizes of 
entries created for external references (BEFs) , address constants, etc., 
aay be helpful when analyzing PHD or ISD work area overflows. Systea 
prograaaers can estiaate the nuaber of additional pages based on the 
entry size aultiplied by the nuaber of additional entries reguired. The 
DSECTs CHATDX and CHAISD, describe coaponents for the PHD and ISD and 
aay aid in deteraining the storage reguireaents • 
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I 1 T ■ " 1 ■ — • " 1 

1 Constant ( Work Area (MorBal Size fleasons for Overf lov/CoH&ents | 


1 CBfWl IWork 1 1100 pages I^oo aany OSIHS or DlOP stateaents | 


1 1 1 1 Insufficient rooa for 2-word cross) 
1 1 1 {reference iteas I 


1 1 1 1 Westing of aacro calls causes gen-| 
f 1 1 feration of aacro level diction- | 
1 \ f (aries tkat required too auch space) 


1 CE¥12 llork 2 |255 pages |!Poo aany sjabols in naae fields | 


1 1 1 |!roo aanj source stateaents | 


1 1 I |Too aany aacro-generated | 
1 1 1 (stateaents | 


1 1 1 (Too aany continued lines | 


1 1 1 1 Insufficient work space for build- | 
1 1 I Jing control section dictionary | 


1 CBVW3 IWork 3 |20 pages per | Insufficient virtual storage | 
( 1 lincreaent, | available for any reguest; | 
1 1 laore avail- linoreasing size of 20 will | 
1 1 (able as inoraally not help. Unload all | 
1 1 r needed to laodules possible i reasseable | 


1 1 1 stateaents |&sseabler*s ?1TIBI.1 filled up. | 
I 1 I 1 Increase size froa 20 pages per | 
1 1 1 (increaent. I 


1 CBVXL I External 9aae|2 pages lluaber of control sections and | 
1 HBXT MAH) 1 lElTRT operands aore than 1022 | 
1 JList Area | | 1 


1 CEVPMD IFMD Work Area) 2 pages plus (Too aany El TBI or EX!PH1 operands j 
1 {(residual ( (nuaber of I with textless or low text aodule | 
1 1 count) Itext pages J (!i?EIir=instructions or constants) | 
1 1 1 divided by | I 
1 1 18) 1 1 


1 CEflSD USD Work ArealO pages pluslTke value of CB?W2 too saall to | 
i 1 (nuaber of (contain IS0 ) 


1 1 (Work 2 |Too auch 0SIW6/D10F inforaation | 
( ) 1 (and syabolic ^aae inforaation for ( 
) i ( (work area I 



Figure 12. Asseabler constants ,^ changeable for large asseablies 



RELEASIIIG IHTEllQCKS AT ABEWD 

Many interlocks in shared tables (coded in TSS systea prograas) are 
released autoaatically by systea routines (for exaaple, the lESTBL head- 
er) if an abnoraal end (ABEVB) occurs. However r systea prograaaers aay 
set locks on shared tables that are not autoaatically released when 
their task is abnoraally terminated. In such cases, other tasks 
attempting to use these tables are prevented froa doing so because of 
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interlocks left on the shared table by the abnormally ended task, fo 
eliminate this problem, system programmers must establish entries in the 
IBEHD interlock release (All) table for all interlocks they set that 
have no predefined system release procedure. These entries contain the 
?- and R-type address constants to a routine (that must also be coded by 
the system programmer) which is to release the interlock in case of an 
IkBEliB. For interlocks of this type, AIS table entries must be created 
before locking the interlock byte. 1 suggested procedure for creating 
an AIR table entry is indicated below: 



IRSPSICT PSECT 
LOCKS! DC 



X»00" 



INTERLOCK SilTCE BEING OSED Bl 
SISTBM PROGRAMMER TO LOCK 
SHARED TABLE: 

00 - UNLOCKED 

IF - LOCKED 



LOCKLOG LOGfLOCK 



SI 



DC 



X»00» 



AIR TABLE ENTRY SWITCH 

00 - NO AIR ENTRY EXISTS 
FF - AIR ENTRY EXISTS 



AIRLST CALL, (IRSPSECT,IRSRTNE,OSEDATA ,) ,1F=L 

♦ DC ? (IRSPSECT) 

+ DC R (IRSRTNE) 

^ DC A(OSEDATA) POINTER TO OSER DATA 



IISEDATA DS 



C2ACS SCRATCHPAD 



CLI 
BNS 
CALL 



M?! 



S1,X»00» 

SKIP 

CZ ACS 1 ,1F= (E , AIRLST) 



AIRSET CSECT SYSTEM PROGRAMMER'S ROUTINE IN 

WHICH INTERLOCK (for example, 
LOCKSW) IS TO BE SET ON 

HAS CZCACS1 BEEN CALLED 

YES, AIR ENTRY ALREADY EXISTS 

NO, CREATE AIR ENTRY (i.e., 

CALL ROUTINE THAT CHAINS ENTRY 

FROM AIRSET 's PSECT INTO AIR 

TABLE) 

SET AIR SWITCH TO INDICATE 

ENTRY EXISTS 

SKIP SETVLOCK LOCKSW , LOCKLOG ONCE HAVING SET AIR ENTRY, SET 

INTERLOCK ONI 

NOW IF YOUR TASK IS ABENDED, 
LOCKSW WILL BE AUTOMATICALLY 
RELEASED BY THE ROUTINE YOU 
SPECIFIED IN AIRLST 
OPNfLOCK LOCKLOG 

CALL CZACS2^MF= (E, AIRLST) 

M?I SW,X«00« 

The system programmer would also include the following steps in the 
interlock release routine: 



SW,X«FF» 
SETVLOCK LOCKSW, LOCKLOG 



IRSRTNE ENTRY 
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CLEfLCXTK LOCKLOG CHECK AMD KESEf LOCKS! BYTE 

M?I Si,X«00» TOBN All SWITCH OFF SO CZACS1 

WILL BE CALLED AGAIM IF fiOU- 
TIHE IS EHTERED AT SOBSEQBEHT 
ABEND 

IBTOBN EETOEM TO CALLER 

The A IE eatrf is automatically released by the system when ABEMD dis- 
patches the system programmer's interlock release routine. 



I POBLIC POOLS — GENERAL DESCRIPTION 

The purpose of public pools in TSS is to divide public storage 
volumes and uses into logical groups- These logical groups,, or pools^ 
consist of one or more volumes with consecutive relative volume numbers 
named by an eight -character poo lid. One pool, called the system pool, 
is required at system startup time. All other pools are dynamically 
added and deleted from a running system. 

Each pool is a self-contained entity. All datasets necessary for a 
pool are contained within the pool. Users are joined to a specific 
pool, rather than to a TSS system, and may own datasets only within that 
pool. Datasets may, however, be shared across pools. A special user in 
each pool, called the pre- joined user owns all the pool's system data- 
sets such as: SISCAT, SISUSE, and SYSBWQ. The pre-joined user also has 
the responsibility for joining and quitting users to his/her pool and 
for the maintenance of the pool, tss***** is considered the pre-joined 
user for the system pool. 

The structured public storage allows the separation of users and 
their data into reasonably-sized, independent groups, divorced from any 
particular TSS system. Groups of users may be moved from one fSS system 
to another. New releases of TSS and PTPs affect only the system pool. 

Public storage backup and maintenance are performed on a pool rather 
than the entire system. Catastrophic DASD failure is localized to one 
pool. Since each pool contains a SISCAT, catalog paging bottlenecks are 
reduced- Special purpose pools for benchmarks and system testing may be 
created. 

The volume label of each volume in a pool contains the eight- 
character poolid and a flag to indicate that it is part of either a sys- 
tem or a public pool. The volume label of the first volume in a pool 
also conatins the pre-joined userid and pointers to SISCAT, SISSVCT, and 
SYSVOL datasets. SYSCAT is the system catalog for the pool; SYSSVCT is 
the index of user catalogs for the pool; and SYS¥OL is a list of all 
volumes that make up the pool* Each pool also contains SYSUSE, SYSBiQ, 
and SYSPLIB datasets. These datasets are owned by the pre-joined user 
and are normally contained on the first volume of a pool. SYSPLIB is a 
pool oriented VP dataset that is data deffed between USELIB and SYSLIB. 
It is used to contain object modules related to a particular pool. 

Several virtual memory tables are used to control the active pools on 
a system . These tables are updated during ADDPOOL and DBLPOOL process- 
ing. The active pool index (CHBAPI) contains the status and control 
block pointers for all pools currently known to the system. The pool 
volume table (CHBPVT) contains a list of volumes for each pool and is 
used to control space allocation for datasets. The userid table is used 
to determine the poolid for a specific userid. Entries in the virtual 
batch work queue are added from a pool's SYSBiQ dataset during ADDPOOL 
processing and deleted during DELPOOL processing. 
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I CDMVEITI^G TO 1 POOL SISTBIi 

I To convert aa existing fSS system into a single pool system, the voi- 

I ume labels of all public ¥oluiaes must be updated to conatin the new pool 

I related inroraation. Ilso^ the SYSVOL datase-t must be built on the 

I first volume- I'his xs a » one-time* process and is pertoriaed by the 

I CUVTPOOL Goamand. The aodif ications to the voiniEe labels and the SIS¥01 

I dataset do not affect the operation of pre-pool systems. 



I ADDIHG J12ID BELBTISG POOLS 

fhe startup process autoiiatically adds the system pool; all other 
pools must be addei by the systea operator, "he shutdown process 
deletes all active pools including the system pool; pools other than the 
system pool aay be deleted by the system operator. The coaiaands S.DDPOOL 
and DELPOOL provide this facility. 

The AD0POOL coiffiand provides a means by which a pool can be added to 
the system, or put into a maintenance status- Maintenance status 
restricts all users in the pool from logging on except the pre- joined 
user, fhis enables the pre- joined user to perform maintenance and bac- 
kup procedures without interference from other users- A pool may be 
removed from maintenance status by issuing another JIDDPOOL command 

(which adds the pool to the system) or by issuing a D2LP00L command 

(which deletes the pool from the system) - 

The DELPOOL command will oDtionally torce active users off a pool. 
If users are not forced, the pool is marked in 'delete status*. This 
delete status prevents new users in the pool from logging on, and pre- 
vents shared datasets from being opened by users in another pool. 1 
pool may be removed from delete status by issuing an ALDPOOL command. 
To delete a pool already in delete status, another DELPOOL command must 
be issued. 



I BUILDING A SEW POOL 

A new one-volume pool is built from an empty private volume by the 
BLDPOOL command using the K0DE=1EW parameter, iith userid TSS***** the 
BLDFOOL command builds the SISVOL dataset and empty datasets for SYS- 
PLIB, SISSltQ, and SISCAT . The datasets SYSOSE and SISS¥CT are built and 
include entries for th pre- joined user- Also, a USEECAT for the pre- 
joined user containing catalog entries for the above datasets is con- 
structed. Finally, the volume label is modified to contain the pool in- 
formation. Once built, a new pool may be added to a systea with the 
ADBPOOL command. Osers may then be joined to the pool by logging on the 
pre-joined user and issuing the JOIi command. 



r ADDIHG fOLUHES TO BXISTIIIG POOLS 

A new volume aay be added to an existing pool by the BLDPOOL command 
using the HODE=ABD parameter with the pre-joined userid. The BLDPOOL 
command updates the pool's SlSfOL dataset to include the new volume and 
modifies the volume label of the new volume to contain the pool informa- 
tion. The new volume will become available for storage allocation the 
next time the pool is deleted and then added %o the system- After the 
new volume has been deleted-added to the system, storage allocation will 
occur on this volume after the next shutdown-startup sequence. 
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PABTITiOHIiG lU EXISTISG POOL 

The process of |>artitioiiing an existing pool into two separate inde- 
pendent pools involves several steps. First, the breakpoint (the rela- 
tive volarae namber ot the tirst volume of the new pool) must be deter- 
■ined. Also, it must be determined that the available disk storage of 
each of the two pools aust be large enough to contain all the datasets 
owned hj the users that will eventually belong to each pool. 

Second, once the breakpoint is deterained, external storage alloca- 
tion for each user of the existing pool is restricted to one of the two 
new pools by the SETRVl coaroand; this establishes the pool to which each 
user will eventually belong- Illocation for new datasets and expansion 
o£ old datasets will only be made within the volume range specified by 
the SETR?K coaaand. 

fhird , to ensure that users do not own datasets outside the volume 
range specified in the SETlfH command ^ a KOVBUSER coaoand aust be issued 
for each user in the existing pool. MOVEOSER will check each dataset 
including OSERCAT for a user and copy the dataset if any part of it is 
outside the volume range. The sharing information and the time and date 
stamp are maintained. The volume range and MOfEOSEB status information 
are kept in the SISSfCT dataset. 

Fourth, t.he BLBPOOL command with a EODB=PAET parameter is issued by 
the pre- joined user. This coamand will test each user in the existing 
pool for relative volume number range consistency and l!0¥EUS£E status. 
This command is canceled if the relative volume range of any user over- 
laps the breakpoint, or if any user has not been checked with a EOfEDSEK 
command. 

The SISVOL dataset for the new pool is built, and the SlSfOL dataset 
of the existing pool is updated. Empty datasets for SISPLIB, SISBSQ, 
and SYSCAT are constructed for the new pool. The datasets SIS0SE and 
SISSfCT are built and include the new pool's pre-joined user. A OSESCIT 
for the new pre-joined user is built to contain catalog entries for the 
above datasets. 

fhe existing pool's STSSYCT is read to determine which users are to 
be included in the new pool and both the existing and new SISSfCf and 
SISUSE datasets are updated accordingly. 

Finally, the volume labels of the volumes in the new pool are updat- 
ed. The new pool may now be added to the system by first deleting the 
existing pool and then adding the two 'new pools' - 

ttllNIENASCE 

Public storage maintenance is now performed on a pool basis rather 
than on a system basis. Since pools, including the system pool, are in- 
dependent of each other, dump-restore of all volumes in a particular 
pool ensures dataset/catalog consistency. Commands such as P&IFIX oper- 
ate on a single pool at a time. I new command, DSCBS, replaces the CPS, 
LPDS, C?¥, and EPS commands, and operates on a pool basis. The command 
BLBSfCT is provided to rebuild SISSfCT for a pool in maintenance status. 
BLDSVCT replaces the SYUCCAT command. A OSERCAT may be rebuilt by the 
new Fixe AT command. 



I PATftSET DSCB RSCOVB BY 

f This item will provide for dscb error analysis and recovery. 



56.2 



TNL GN204106 (01 July 80) to GC28-2008-5 

In order to accomplish this 2 now types of DSCB"s have been defined, 
a tyBe 2 format "E" , and a new format "G". The type 2 "E" contains the 
same dscb type code X»01» but is marked as a type 2 by a bit in the 
dseflg field of the dscb. The new "G" dscb contains the code I»03' in 
the dscb tyoe field . 

The £P5s (external Da ge entries) for both new dscbs have also been 
redefined* The new format is: 

srvxppppr s = slot 0-f 

r¥ = relative volume number 0-ff 

X = zero 

pppp = relative cage number 0-ffff 

In addition^ the following new fields have been added to the "G" dscb 
to aid in dscb integrity and recoverablity : 

DSGSEOC^) "" dscb seei!9nce counter 1,^2,3,, ^n 

DSGFKTE(U) - oointer to the format "E»» dscb 

DSGCTEPE(1) - count of epes in the dscb 

DSGKIXfl) - maximum number of epes this dscb may contain 

The format "E" pointer contained in the format "G" dscb is used as an 
anchor to the format "F" - The seguence counter is used to indicate 
where in the chain a dscb slot beionas. I new command "FIXDSCB" (see 
commands section) has been written to analyze dscb slots and their 
contents r and attempt recovery if errors are detected* This command can 
only analyze dscb chains in the new format .► 

CZCEW (write dscb) has been rewritten to create only new format 
dscbs. However y as released CZCEW will link to CZCEV (the old write 
dscb routine) and continue to create dscbs in the old format. 

Creation of new or old dscbs is controlled by the followino patches: 

SET CZCEMKLL = X»4700» allow new dscb creation 

= X»47f0» create old format dscbs for all datasets 

the above patch will cause new format dscbs to be 
converted back to old format dscbs. 

SET CZCEWNEW = X»4700» create new dscbs for all datasets 

= X»4770» create new dscbs for new datasets only. 



V&LIDATIIIG DSCB SLOTS 

System progranners occasionally fiad it necessary to modify or valid- 
ate DSCB slots. The checksua is used to validate DSCB slots. 

If a programmer reads in (via a SETXP system macro instruction) a 
page of DSCBs and locates the DSCB he wants to examine^ he can verify 
that the DSCB was read in correctly by executing the checksum procedure 
described below. He computes the ckecJcsua of that DSCB and compares it 
Mith the checksum value already recorded in bytes 255 and 256 (the chec- 
ksuB field) of that DSCB. Whea the checksums aatch^ the DSCB is assumed 
valid. If they do not match, that DSCB slot is assuaed to be erroneous. 
The system programmer should then attempt to recover^ as far as possi- 
ble, froa the checksum error. The system service routine, DSCBREC (see 
Systea S ervice Routines I , can be used to attempt this recovery. The 
DSCB page can be writtea on external storage through use of the PGOOT 
syste®, a aero instruction. 
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iheaever a systen programmer modifies a BSCB, lie Eust recoapute the 
diecksum value, record it in tlie DSCB checksmm field, and rewrite the 
BSCB page to external storage. 

Ctiecksuffi Procedttre 

The following standard procedure is used for coaputing the checksum 

values for BSCB slots. The first 6 3 words of the DSCB are suaaed and 

the sua coaplenented . The high-order half (bits 0-15) of the result is 
then added to the low™order half (bits 16-31) and the low-order half of 
the result is placed in the last halfword (bytes 255 and 256) of the 
DSCB. 

This sample code illustrates the checksum procedure. Upon entry, 
register 8 contains the DSCB slot nuiiber, and CKID contains the virtual 
storage address of the DSCB work page. 



CKSOH 



SLL 


R8,8 


IL 


BB^CKID 


LA 


R14,24ft 


L 


R 15, 248 (M8| 


&L 


R15,0{R14,1S) 


S 


114pC0MCK 


BC 


11,CKSIIK 


LCI 


115, R15 



SLOT MO. *256 

+ IDDE. OF DSCB PIGE. 

SET COUIT MD 

LOAD LAST iORD 

IDD IK PPE¥IOOS WORD AID 

REDUCE WORD COOiTSF BY DME, 

IF HOT PIMISHED, CONTIflFB. 

COMPLEMlil STJK AID 
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STH 
SBL 



EIS^CKSX 

115^16 

115,C1S 



SfOHl LOf-OlDEl RILF. 
SHIFT DOm HI-OBDll HALF, 
IDB If LOM-ORDEE HiLF AIB 
PEIFOBH STH OB CH. 



***IF DSCB IAS MODIFIED, STOBE MEW CHECKSUM fALUB*** 
STH B15,25«I(B8) STOBB BESULT IH DSCB. 



***IF SIMPLY fEBIFlIlG DSCB IAS BEAD-Ill COBBECTLI*** 

CH B15r254(B8) COMPABB WITH EXITIHG CHECKSOM 



COICK 


DC 


F«4« 


CKS 


DC 


H»0» 


CKSX 


DS 


H 


CKAD 


DS 


F 



COUBT DECREKEIIT COMSTABT 
SUMMATION WOBD 

DSCB lOBK PAGE ADDBESS 



VIBTPAL MEMQ BY SPPBHVISQB CALL IISTBPCTIOIS 

lirtnal Memory supervisor calls are tkose S¥Cs vhose processing pro- 
grams are in virtual storage; these STCs use operand codes through 
127- Codes through 99 are reserved for nouprivileged progran defined 
services vhile codes 100 through 127 are reserved for privileged program 
defined services* 

Many of these s?Cs can be executed only from nouprivileged code; if a 
privileged module attempts to execute them, diagnostic messages vill be 
issued. When a nouprivileged supervisor call is issued, the supervisor 
passes it back to the task monitor as a task-SVC; no task program inter- 
ruptions are generated* The task monitor transfers control to the ap- 
propriate privileged (or nouprivileged) program for processing. 

Honprivileged programs can neither read, write, nor transfer control 
to privileged programs directly; some form of interruption (for example, 
the interruption caused by execution of an SVC instruction) is required. 

The Virtual Memory SfCs described in this publication are listed in 
Appendix B. 

BEAL BEMOBY SOPEBVISQB CALL IMSTBDCTIOMS 

The SVC f ueue processor controls the execution of SVCs 128 through 
255. Codes 128 through 1*13 are reserved for installation use, codes 144 
through 169 are reserved for TSSS, and codes 170 through 255 are resi- 
dent supervisor SVCs* 

System programmers (P or 0) may issue all resident supervisor SVCs 
(170-255) . Any program operating in the privileged-program state (VPSl 
p-bit = 0) — even if being run by a user-programmer — may issue all 
the Beal Memory SWCs^ The Beal Memory SVCs described in this publica- 
tion are listed in Appendix B. 

If a nouprivileged program being run by a user-programmer attempts to 
issue a Beal Memory supervisor call, the resident supervisor may create 
an extended program interrupts. Ihen the task monitor receives the in- 
terruption, it calls DIAGHO* Generally, supervisor calls that^can dis- 
rupt the operation of TSS are privileged. Supervisor calls that allow 
access to private information are also privileged. 
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Usually, tlie operation requested bj a Beal leaory S¥C is a syack- 
ronoiis one wkicb is completed by the resident supervisor before it 
returns control to the task that issued the S?C, The principal excep- 
tion to this is lOC&L, an asynchronous SIC, vhich is processed concur- 
rently with the issuing task. 

Task program interruptions, which nay result from improper use of 
these macro instructions, can be found in Appendix C. 



&CCESSIIG SYSTEM DATA SETS 

Access to the system catalog and the user table is restricted to sys- 
tem programmers having an authority code of O and to certain privileged 
routines, such as catalog service routines. Access to all other system 
data sets is available to system programmers hciving either authority 
code O or P. 

SYSBB POMP 

To facilitate your monitoring of the system, dumps can be taken to 
show real or virtual storage as they existed at the time an error was 
detected, then the system error prociessor is called by the SllOS macro 
instruction (SVC 254) or the STSEl macro instruction (SVC 228) , a mes- 
sage is displayed at the operator's terminal to record the error. The 
system then enters the wait state and the operator uses the support sys- 
tem to take the dump and, if hard copy is desired, to print it. After 
the dump has been taken and control returned to the system, processing 
continues as described under the EHBOl and S7SEB macro instructions. 

If the call to the system error processor came from main storage 
(real core) via the IBBOB macro instruction, the following message is 
displayed at the operator's terminal: 

<EB> Bl mmnn{l!IHIMAJ}userid TID {C|»} {SYS Ill}hhmm 

CP!I# SP=SVC PSl 

HOBULE: module name base address 

BEGISTEBS: 0-15 

where the elements have the following meanings: 

• <EB> identifies the message as being issued by the system error 
processor. 

• BI identifies the call as having come from main storage (real core) . 

• mmnn is the four-digit BBBOB code that identifies the call (see the 
description of the EBBOB macro instruction for an analysis of the 
code) . 

• (IIM) identifies the error as type-lj (HA J) identifies the error as 
type-2. 

• llll>=userid identifies the user whose task was running when the error 
was detected by means of his eight-character user identification, or 
userid, which is contained in the TSI. 

• TID=taskid identifies the task that was running when the error was 
detected by means of its four-hexadecimal-digit task identification, 
or taskid, which is contained in the TSI. 

• C indicates that the task that was running when the error was 
detected was conversational; 1 that it was nonconversational* 

58 



TNL GN20-4106 (01 July 80) to GC28-2008-5 

• S¥SIl=xxxx specifies tke f oiir-liexadeci«al-digit sfmbolic device 
aMress contained in tlie TSI. 

• kkMiL imdicates the time in hours fhli) and ainutes {»m) at nkich the 
error was detected • 

• CPU= indicates the number of the CPU 

» SP=SfC PSl at the time of the SXSEl call 

• lODUI-l: identifies the modale that issued the SISBK: call and its 
base address 

• lEGISTllS: indicates the contents of general registers - 15 at the 
time of the SYSEl SIC 

If the call to the sfstea error processor came from a privileged rou- 
tine in virtual storage via the SYSBl macro instruction ^ the message is 
modified slightly and takes the form: 

<EH>fH aabbcccnn[MIl|lIJ| userid TII){C|1} {SfSIl)hhm» 

CPO# SP=S¥C PSl 

lODOLE: module name base address 

ISGISTEBS: 0-15 

where those elements in common with the main storage (EC) message have 
the same meaning and the remaining elements have the following meanings: 

® ¥M identifies the call as having come from virtual storage. 

« aabbcccnn is the nine-digit SlSEl code that identifies the call (see 
the description of the STSEB macro instruction for an analysis of the 
cod el . 

The information identifying the task fUID^ TID, SYSIl) is always 
valid when the call is from virtual storage; it is not necessarily valid 
when the call comes from main storage. The task identified in the mes- 
sage resulting from a main storage call is the last task dispatched by 
the supervisor. However, since the supervisor can perform many func- 
tions before dispatching another task, the task names in the message may 
not be the one causing the problem. -Whether or not the task information 
is valid must be determined by the system programmer - 

For conventional tasks , the symbolic device address is that of the 
terminal from which the input stream is being entered , while for noncon- 
versational tasks ^ it is the volume on which the SYSIl data set resides. 

For all errors detected in bulk I/O and batch monitor tasks as well 
as in the main operator's task, the user ID is SYSOPEEO. To distinguish 
among these, you must use the four-hexadecimal-digit task 
identification . 



I RELIABILITY AIDS 



I lUTOHITIC ISA REPLACEHEIT 

I STABTOP saves the critical portion of the ISA in the supervisor and 

f the pointer and length of the saved ISA in CHBSYS. CEAA2 and CEAJI 

f compare the saved PSWs with the task's ISA PSWSm If they are not the 

i same^ the ISA rebuilder, CEAA22, is called. This permits a task whose 
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f ISA has been overwritten to have the critical nrotions of its ISA 

f restored, thus allowing the task to be deleted gracefully; otherwise, 

I the task would go into an unending loop and cou,ld not easily be forced 

I from the system. 



I Barrier Pages 

When STARTUP loads the virtual memory modules it generates a barrier 
page for each LLIST macro in CHB?a with operands BIFPIEF=PHI¥ITH/SHIRED , 
putting the pages in private or shared memory as requested. STARTUP 
will also generate a barrier oage immediately following the ISA plus one 
at location »F?FOOO'.. 

HEAD ONLY PAGE OVERWRITE PROTECTION 

STARTUP identifies all csects with the read only attribute, and sets 
a flaq in the External Page Table entry for each read only CSECT* This 
can be overruled by a parameter ROPHOT=N in the load list. 

If a read only paae is f oun 1 to be changed by the TSS supervisor a 

•338^3• real core minor SYSER will be issued. Reqister will contain 

the ?MA and register 1 will contain the FMi^ of the changed page (for 

shared pages, register is relative to the start of the shared page 

table) . After issuing the SYSER the changed version of the oage is 
thrown away and a fresh copy will be used the next time the paae is 
referenced • 

T%Jo switches in CHBSYS may be used to alter the read only oage 
protection. The switches are *EF' bytes into CHBSYS. The first switch 
CX»80») will stop all read only Baae protection. The second switch 
(X»40*) will detect changed read only oages, but will turn off the read 
only bit in the XPT and continue with the chanoed pages. 



HODIPYIIiG SY ST EM FACILITIES 

To change TSS, fOE will probablf follow a procedttre like this: 
1« Defise tke function to be accoaplislied . 

2. Identify the modules to be added, changed, or deleted. 

3. Define the interface of these Modules with all other TSS Modules. 
The control section dictionaries of modules in the system pro¥ide 
fou with a listing of all the nodule's external references (lEFs) 
and external definitions (DBFs). This is a start in determining , 
for exaaple, how an existing aodnle fits into the s jstea • Care 
amst be exercised, as this information nay be deceptive. For exam- 
ple , an external address can be loaded into a register, and the 
register f instead of the external address) can subsegaently be re- 
ferred to in the progroiii . fon might see this: 



BOLD L 5 , =¥ fCHBSYS) 

IISIIG CHASIS^S 

SHAKY L 6rSYSL01 

L 7,60 15) 



SYSTEM TABLE ADDIESS 
FORHAT OF SfSTEl TABLE 
BXTEIHAL SEFEIBICB 
BITBHIAL lEFBIElCB 
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Tke symbol CHBSIS is an extermal sfabol and would appear Ie the 
control section *s dictionarf as an external reference {EEF) . flie 
reference to SISLOW wo^nM not appear as an external reference ^ 
thongliy and the reference 60(5) isn't even a syabolic reference. 

fbe cross -reference dictionary would show fo«i that statement BOLD 
refers to the externally defined symbol CHBSIS; jou have t€> figure 
out that SWEIIf also refers to it. 

Unfortunately, there's no convenient nay to determine vhat pro-- 
fraas refer to the external symbols defined in a given program. 
The instrnction: 

ENTtl IBCBJG 

allows other programs to refer to the symbol IBCBJG • There is no 
guarantee, however ,r that other programs will actually refer to 
IBCEJG. Consequently, if yon delete a program from TSS^ yoa have 
no systematic way to detemine which programs refer to the prograa 
you're deleting. Yon can discover the references only by carefully 
studying the function of the program being modified or repldced and 
by understanding its role in the overall design. 

Yon might be tempted to list all the external symbol dic- 
tionaries of all the object aodnles that make np TSS, as a way of 
determining their inter dependencies. This might be helpful,, but it 
is not foolproof. Some programs set np registers with external ad- 
dresses for use by other programs that know what the registers are 
supposed to contain. I program nsing registers set ap by another 
program might not contain a single explicit external reference- 
Yon might see this: 

OBVIOUS L 6,=fCCBBSYS) LOAD ElTlllM, SYHBOL 

L 15,=? (SNEIKYl LOID IDDl OF SUBIOOTIIB 
BISl 14,15 TlllSFEl 

The subroutine might look like this: 

ISIIG *,15 DECLIIE BISE 

SNEIKY L 8, 12 {6) HIDDIS XITEllIL lEFllEICE 

The external reference to CHBSYS would never show up in the exter- 
nal dictionary of the program module containing SIEAKY. Mote that 
the best coding practice would have been to cover register 6 with a 
DSBCT for CHISYS and address the field symbolically. 

ft. Write the assembler statements. 

5- Assemble and test the new or amended modules and store thea in the 
same library. 

6. Update the TSS system data sets using the procedures described in 
System Generation and Kaintenance ^ 
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PIOGIII COITIOL STSTll (BCS) 

Thm program control sjstmm (PCS) is not,, in general, applicable to 
sfsten prograns* For ezanple, one PCS coanand, tlie CI.!.!, conmand, always 
transfers control in the nonprivilegei state ani, therefore, cannot be 
used to transfer control to a privileged program, fke privileged systen 
progranner {antboritf code O) wbo wisbes to directly invoke a privileged 
progran nnst do so by inclnding a BPIB macro instrnction in tbe program 
and issuing a BUILTIl command. {See tbe BPKD macro instruction for a 
full explanation.) 

Tbree PCS commands can be used with privileged system programs, 
fkrongb tbe SET command, privileged system programmers can modify privi-- 
leged, public control sections; tbis is tbe only way in wbicb sncb con- 
trol sections can be changed from a terminal. In addition, privileged 
public control sections may be examined by tbe use of tbe BISPLJkf and 
BUHP commands. Tba following discussion covers tbe precautions yon mnst 
observe. 

lacb B-class user is assigned an antbority code by JOIl: code P spe- 
cifies a system programmer, O specifies a privileged system programmer, 
and code B specifies an ordinary nser. Wben someone logs on, tbis au- 
thority iTode is used to govern tbe operation of the dynamic loader and 
the use of PCS. 

the dynamic loader ignores or overrides control section attributes 
depending on the programmer's authority code and the library from which 
the module is loaded. If you are a system programmer with authority 
code P, you can test nonprivileged system programs. These programs can 
be dynamically loaded from any one of the three major libraries. If the 
program is loaded from either JOBLIB or BSllLIB, it is assigned to pri- 
vate, read/Write storage. The attributes of public, read-only, system, 
and privileged are overridden. If it is loaded from SYSIIB, only the 
public and read-only attributes are overridden. Is a result, you get a 
private copy of any module dynamically loaded from SYSLIB. Privileged 
modules so loaded remain privileged and write/fetch protected. This 
provides continued protection for the privileged routine. 

Because of your authority code D: 

• ¥ou may use all PCS commands in testing your nonprivileged programs. 

• fou may use symbolic addressing to display or dump any privileged 
CSlCTs which have been dynamically loaded. 

• fou may display or dump the contents of your task's virtual storage. 

If you are a privileged system programmer (authority code 0) , any module 
you dynamically load is assigned to private read/^rite storage. Only 
the attributes of public and read-only are overridden by the dynamic 
loader. 

Tour PCS capabilities with respecrt to privil,eged programs are the 
same as they are for a nonprivileged system program (except that the IT 
statement cannot be used in a privileged program) . In addition, you can 
display, dump, or set IVl. fou must exercise extreme caution in setting 
IVH, particularly in a multiprocessing environment, since other CPUs may 
be using the coding you are setting. 

fou cannot use other shared coding in the system for PCS testing, 

since it is not part of your virtual storage. 

The PCS commands and their functions are discussed in detail in the 
Command System User's Guide . 
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Till SHIIIIG SPFPDIT SYSTEM (TSSS) 

For a cosplet© definition o£ TSSS, its cosiiand language, and its 
Bodes of operation, see Ti»e Sharing Support SYStea > GC28-2006. The 
following discussion is intended onlj to introduce you to its facilities 
and use. 

TSSS has two parts, a lesident Support Sjstea and a firtual Support 
SfsteM» The lesideat Support Systea PSS) is very nearly independent of 
TSS; when it is invoked, TSS activity is temporarily suspended and ISS 
has access to all real storage and to the virtual storage of all current 
tasks. The firtual Support System C^SS) performs the saae basic func- 
tions as does BSS; however, it is invoked within an active task, relies 
on the TSS resident supervisor, and is time-sliced. 

TSSS is a aaintenance tool which has been developed for the systea 
programmer (authority code O or P) . It is independent of machine con- 
figuration, and, depending on mode of operation, it may be activated by 
pressing the CPU external interruption key, either from a remote termi- 
nal location or from predetermined points within a task during TSS 
execution. 

When you are using ISS you are referred to as a Master System Pro- 
grammer CHSP) ; when you are using VSS, you are referred to as a Task 
System Programmer C^SP) . There can be only one MSP at any given time, 
whereas there can be more than one TSP, but only one per task. 

TSSS has its own command language; it is constructed from the follow- 
ing elements : 

Commands 
Symbols 
Literals 
Operators 

Commands 

The following is a list of the commands that you can use with TSSS: 

• IT - Places a linkage to TSSS at a specific point during TSS execu- 
tion. The IT command must be followed by at least one other TSSS 
command, the one that will be executed when the specified location 
is reached. 

• CILl - Provides access to command statements that are on tape or in 
the card reader. 

• COLLECT - Iccumulates data into a selected data field. 

• COllECT - Joins a TSP to a conversational task. 

• DEFIIB - Create temporary SP symbols. 

• DISCOMIBCT - Removes TSSS capabilities from a terminal that is dedi- 
cated to an MSP or TSP. 

• BISPLII - Displays data at your terminal. 

• DOMP - Displays data on an output device. (fou must establish the 
output device prior to issuing a DUMP command by placing its address 
in the $DOUT data field.) 

• BID - Terminates the reading of command statements from a device and 
returns control to your terminal. 
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• IF - Designates that the executioii of smbsefuemt connands is 
cxinditiomal. 

• PlfCH - Temporarily overlays the contents of a data field. Its pre- 
vious contents are saved. 

• QOALIFX - Defines or changes the implicit meaning of subsequent 
operands • 

• lEHOTl - Deletes patches, and implanted Ifs and their associated 
statements. 

• HUH - Be turns control to TSS without disconnecting your terminal. 

• SIT - Inserts data into a specified data field. 

• STOP - Beturns control to your terminal after statement execmtion. 
Symbols 

fou may use the following types of symbols with TSSS: 

• External Symbols - lefers to the actual freal or virtual) storage 
address of a data element. 

• System Symbols - Befers to and qualifies storage areas. The first 
character of each system symbol is a $• 

• SP Symbols - Defines and assigns a symbolic name to a data field. 
The data field defined by an SP symbol may exist in the system pro- 
grammer's working storage or it may be a TSS data field. 

Literals 

lou may use the following types of literals in the TSSS command 
language : 

Decimal Integer 

Hexadecimal 

Character 

Operators 

You may use the following types of operators in TSSS c:ommand state- 
ment operands: 

Arithmetic 
Belational 
Boolean 

TIBMIH&L ACCESS METHOD fTAHII) 

The following is a short overview of what TAIII is and how it is 
organized. 

What is TAMI I? 

TAIII is a package of modularly designed programs for providing a 
user-directed, device -independent, terminal-computer interface. It pro- 
vides both device dependent and independent functions for system and ap- 
plication programs. 

TAHII provides a system programmer with a concise and well-defined 
interface for adding both new devices and/or new device function. 
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Til II was iesigmei ani writtem to do tke follovliig for fSS: 

(1) lap rove hittmaa factors bj 

® providing a tiser-teraiaal interface midier alsost direct con- 
trol of tlie user, throiigli user cosBands and defaults 

• use of bnf fering on input and output 

• better user oriented error reiroverj; error recrovery 
interacts with the terainal nser to correctlf handle recx>w- 
erable errors. 

• increasing coaannications line reliability dne to better 
error recovery. 

(2} Increase systea perforaance and throughput (via buffering on 
inpnt and ontpnt) 

C3) Increase maintainability , reliability , and extendability by 
separation of function, nodularity of c^ode, and table driven 
device support. 

Til II provides the following basic services for the system and appli- 
cation programs, and users: 

Establish, terminate, and control access between tasks/application 
programs and communication lines 

love data between application programs and communication lines 

laintain a device and data independent interfa€:e between task/ 
application programs and communication lines 

Establish and maintain a well-defined interface between device 
dependent modules and common system provided routines 

Permit tasks, application programs and users to share communication 
lines, controllers, and terminals 

Permit monitoring and altering of the telecommunications network 

Handle device dependent and independent reguests interchangeably 

Complete input and output buffering transparent to the application 
program but under direct control of the user 

leliability, availability, and serviceability aids to assist in 
maintenance and extending device-function support 

Place the user's communication environment under the user's direct 

control 

Illow a priority seguence of interrupt processing, by an applica- 
tion, for operations to and from a terminal, fllll supports the 
following types of interrupt processing: 

Device 'EXITLIST' ISTIC 

Ipplication program general •ElITLIST* ISTIfC 

SIR S DIE interrupt gueuing ISlf C 

FIIBQ work polling capability SXIC 

•CHECK" capability SllC 
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COIPOSITIOI OP TIIII 

TAIII consists of four aain coaponents: two residing in the resident 
supervisor and two residing in the tasks initial virtual storage. The 
resident supervisor components are ITll (Real Terminal Access Kethod) 
and a set of DCHs (Device Control Hodules) . The virtual storage coa- 
ponents are ¥TSS (Virtual Terminal Support Sjstes) and a set of FCMs 
(Foraat Control Hodules). See Figure 13. 



RTJIH — Beal Terninal Access Method 

RTAH contains six coaaon sjstea control aodules. ITAH controls all 
interacrfcion between the sjstea and the DCHs to provide one coaaon inter- 
face between BTAH and the sjstea, and between BTAl and the DCHs. 

The following are the RTAH aodules and their associated functions: 

1p ClATA - interrupt handler, I/O coapletion and I/O request queue 
initiator for non-shared lines 

2. ClATB - ATCS SVC handler; handles all task I/O requests, and 
supervisor I/O requests. CEATB validitj checks the request, 
generates a request eleaent (a buffer) for the request, queues 
the request on the pending request queue in its correct priori- 
tj position, and calls the DCH to process the request, if 
required 

3. ClATC - subroutine pool one; contains coaaon subroutines used 
bj both BTAH and the DCHs 

1. ClATD - environment S^C handler; handles the SAfBFP, RSTBFP, 
and SITTCT requests: 

SAfBFP - saves all pending and not active I/O requests 

BSTBFP - restores to the pending queue previouslj saved 
buffers 

SITTCT - sets, resets and interrogates flags in the TCT for 
the task 

5. ClATl - subroutine pool two; extension of ClATC 

6. C1AB4 - HTT related SVC handlers: 

com - connect an HTT task to the sjstea and aake known a 
■BEGI1» application naae to the sjstea 

DCOH - disconnect an HTT task froa the sjstea and delete the 
application name froa the »BEGIH« table; also used to inhibit 
(IL060H) and perait (PLOGOI) BEGII requests for an application 
task 

CKALOC - performs two functions: 

Hark a terainal under task control for lOREQ use (TAHII 
gives up control of the terainal) , and release a terainal 
froa task csontrol and return control to TAHII 

Force coaaunication line initialization for network control 

ATTACH - used to logicallj attach a separate function to a cur- 
rentlj active terainal 
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LCOIN - connect requested terminal to task nnier f IIII control 

OFLOl - SVC is ttsed to interrogate ani set the allowed count of 
users for tke sfstes and HTf application prograss. 



DCH - Device Control Hodnles 

DCHs are supposed to be line controllers. It is the DCl»s responsi- 
bility to get the data to and froa the terainal* Ideally, the BCH has 
no knowledge of the actual terainal at the end of the coaaunications 
link. DCHs are noraally table driven froa a Device Control Library 
Entry called a DCI. 

It is the DCH*s responsibility to handle the following functions when 
required : 

Does final validation of all I/O requests 

Builds the required channel prograas to perfora the I/O requests 
and initiate the I/O 

Maintains line control during non--activity between terminal and 
task 

Handles the initialization required for connecting a terainal to a 
task whether initiated by the user or the task 

Sets up device dependent inforaation in the required systea control 
blocks 

Handles all device dependent interrupt status other than channel 
end/device end and systea FCI chaining requests 

Provides error recovery for all abnoraal endings 

Handles device dependent tiaer routines 

Provides siaple output edit capability for supervisor aessages to 
the terainal user 

Deteraines length and type of input and checks user's input for 
user and hardware funcrtion requests f cancel, attention, etc.) 

the following DCHs have been iapleaented: 

C1DH01 - contains two funirtions which are used by C1DH02, C1DH03 and 
CEDHOil. 

CBDll - an input data interrogator. ClDIl handles input 
length deteraination , special control character function 
handling (e.g., ATTEMtions, line cancel, device control coa- 
aand deteraination and input buffering control function) , 
and SOLICIT a aero support. 

CEDIE - handles all error recovery and other unexpected or 
abnoraal status coapletions for I/O requests. 

CEDH02 - handles 27iH support. 

CEDH03 - handles ISCII terainal support, specifically TT¥33 and 
TfY35. 

CEDH04 - handles 3215 operator console support. 
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C1DM07 - handles 3270 support. C1DM07 does not use CEDlOl, but does 
its own input determination and uses CED109 for error reco- 
verf . 

CEBM08 - handles the 3066 console support for the 1168 operator cxjn- 
sole CBDH08 uses C1DH09 for error recoverj • 

C1BM09 - error recoverj for CED107 and CBBM08. CBDlOS's error reco- 
very is Bnch simpler than the error recovery used for CBB102 
and CED103. 



BTAM Control Blocks 



CHIITCS - virtual aenorf parameter list for regmesting ITIl to per- 
form some I/O regnest. fhe parameter list is pointed to by 
the executed ITCS SVC fSVC X»I>B»J • 

CH&BFP - I/O regnest control area and data area. Contains informa- 
tion in the header area describing the regnested operation, 
fhe data area contains the nser^s data for omtput 
operations. 

CHlBFPs are chained forward and backward ^ in a circular 
chain. The first entry in the chain is pointed to by the 
TCT {TCTBBF) . 

CHIDCLE - device control library entry. The CBIDCLl is a read-only 
control block used to drive the Device Control Hodmles and 
to set up the initial terminal environment at initial con- 
nection time. The DCLE's field definitions are dependent 
only on those DCHs that are to reference it. 

CHiEES - a dsect covering the error recovery error report built to 
record permanent and intermittant errors for VMBIBP 
handling. 

CHAMTS - system control block used for controlling user access to the 
system or to special application tasks. The ITS contains a 
pointer to the segment table which contains the shared 
translate tables. 

cailHSG - the IISG is ITIH's message file. The IISG contains all of 
the messages used by BTIK for communicating with a user. 

CHASCN - the SCI is a SYSGEl built table describing all I/O devices 
on the system. The SCI is used by HTIl as a base pointer 

for ITIM control block chains. 

CBATCT - terminal control table entry. The TCT is HTll»s main con- 
trol block. Every other chain or control block used by RTII 
is headed in the TCT. The TCT is also used to maintain line 
status information for connected lines. 

The TCT is pointed to by CHISCl (SCITCT) and by the owner 
task«s TSI if there is one (TSITCT) . 

CBATII - task interrupt information block. The CHATII is a dsect 

covering the CHIBFP after the BFP has been reformatted for 
task I/O completion posting. 

CHITIO - terminal I/O control block. The CHATIO describes the I/O 

currently in progress on the line. The TIO dsect covers two 
separate control blocks. 
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(a) Tlia sain TIO blod: contains the channel prcigraa needed 
to perform a requested operation* The TIO is pointed to bf 
the BFP vhich describes the I/O refnest being performed • 
For certain line control operations, there maf not be a BFt* 
The cnrrentlj active TIOCB is pointed to hj the TCT (TCTTIOJ 
for the line. 

Cb) The second control block is an error recoverj statns 
save area. It is pointed to bj the TIO which contains the 
error interrupt. 

CHATlAl - shared translate tables. The CHITIII dsect covers the 

translate tables vhich are shared betveen virtual Beaorj 
and BTIH. Thej cxintain tables for perforsing line code to 
EBCDIC and back translation besides tables for folding and 
reverse folding EBCDIC codes. 

ClITSI - task status index. The TSI is the »ain resident task con- 
trol block. The TSI contains a pointer (TSITCT) to the TCT 
for the task's STSIl/SYSOPT. The TSI also contains a point- 
er to a list of connected terminals for ITT applications. 



¥TSS - firtnal Terminal Snpport System 

VTSS provides the common virtual storage interface betveen TABU and 
the application program and/or task. fTSS handles all the user's re- 
guests for connecting/sen din g/^eceiving data, and disconnecting a logic- 
al terminal. VTSS attempts to provide complete logical device support 
for the application programmer, and consists of eight modules: 

CZFTA - I/O request macnro handler. Using the user's environment, the 
macro request code, and information about the FCH from the 
FCL, it determines what sequence of requests must be done to 
fulfill the request. 

CZFTB - I/O completion interrupt handles; handles sjnchronous and 
asjnchronous interrupts from ITAB for the task. Also does 
all processing needed for the ■EIITI.IST' support and 
initiates the virtual storage connection process when a user 
connects to a task or an ITT application program residing in 
the task. 

CZFTC - default extractor; gets defaults and sets the appropriate 

flags and fields for both TABU and the user's environment. 
For O and P authority users, also handles the ¥SS device sup- 
port default at logon time. 

CZFTD - connect and disconnect; called to ironnect and disconnecrt a 
user and/or the user's SISII/SISODT components for TAIII bf 
building the required control blocks. 

CZFTE - terminal profile handler; handles the merging of the user's 
requested terminal session environment with the terminal's 
format requirements. Also handles the saving of the user's 
environment for profile processing. 

CZFTG - device control command processor; handles all processing for 
the user's entered device control commands (screen commands) • 

CZFTP - common VTSS psect. 

CZFBFP - subroutine pool; contains buffer allocation routines, ATCS 
parameter list build routine, and other common routines. 
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FCi - Fornat Control Hodnles 

Foraat Control Hodules are responsible for translating a nser*s out- 
pnt data strean into a forn and sequence which the end deTice will ac- 
cept and act upon in the waj the user expects. On input, the Fornat 
Control Hodule is responsible for renoving all device control informa- 
tion and setting up the data into an EBCDIC stre^i for the using pro- 
gram • !Fhe FCH is set up to handle a class of devices or access methods i 
e.g., CZFHOO handles all interactions with datasets. 

It is the FCl«s responsibilitf to handle the following functions when 
required : 

1. For output — 

• edits output data against user function table 

• does anf blo<dc or re<:ord formatting required 

• handles an; physical line length limits and anf required con- 
trol character sequences 

• translates output data to line code 

• invokes correct routine to do I/O 

• checks return codes and sets up correct return code for the 
calling module 

2. For input — 

• translates input data 

• removes anf block and-or record format headers, etc. 

• deletes anf device control characters 

• edits input data against user function table 

• moves input data to correct input area 

• checks return codes and sets up correct return codes for the 
trailing module 

3. Control requests; performs control function bf either continuing 
the calling sequence or exercising its own code. 

4. Maintains correct sequence and buffer links for buffered re- 
quests in virtual storage. 

5. Handles anf associated functions required for support of owned 
devices; e.g., conversational buffer. 

6. Performs anf special initialization which maf be required for 
connecting a device. 

7. Performs anf special processing which maf be required for dis- 
connecting a device. 

the Format Control Modules currentlf supported are: 

CZFIOO - handles all operations with datasets. CZFHOO supports the 
following dataset organizations: QSJLH, VSAM and VISAS 
(region and non-region) . 

70 



CZFHOI - handles all supported liard copf terainals* 

CS^FiOS - handles the conversational buffer used for support of dis- 
plaf terminals^ CZF105 is device independent. For actual 
device dependent acrtivities CZF105 calls a second level of 
FCHs to provide the actual device dependent support: 

C2F3270 - local 3270 support 
CZF3066 -^ 3066 Console support 

VtSS Control Block Definition and Setup 

CHAlfT - Virtual Hemorf terminal header control block • CBIfITT is 

contained in CZFTP and is the head for the task's terminal 

and user tables. CHIITT contains the following table 
headers: 

(1) List of user^s tables - if ITT/IOT tfpe of task 

(2) list of ITIH-owned terminals connected to the task. 

(3) List of non-lf AH -owned terminals and pseudo terminals 
connected to the task. 

(4) MfT work area pointers and saved work area pointers for 
exit from the HTT state. 

List (1) above is organized bj user number. The USI parame- 
ter on all the TAHII macros is used as an index into this 
list to get to the Oser*s Terminal Control Block (CHIVTCB) . 
See Figure 13. 

Lists 12) and (3) above are essentiallf the same. Thej are 
organized bf lelative Line lumber (SLI) . The ILl is assign- 
ed at connect time by ITIH for ITll-owned terminals or by 
the Connect Hodule (CZFTD) if the terminal is not supported 
by RTIM. The ELI is a half word number with zero being valid 
and a X"8000» denoting an unassigned ILl entry. Bit 1 
CX»4000») determines which list the ILM pertains to. ETIH 
list — list (2 J ~ bit 1 is a 0; non BTIl^ bit 1 is a 1. 
For further information, see the CHITBEM description. 

The MTTBfP pointer determines which work area is in use. 
For normal TSS there is only one work area, for IM? there is 
an expanded active work area assigned and the original TSS 
work area is pushed down by being saved in ITT... and 
MTTBFP being changed to point to the new area. 

CHIVTCB - Virtual User Control Block. One CHIVTCB is assigned for 

each connected user of a task. The VTCB contains pointers 
to the FCLs Csee CHIFCL description below and figure 11) 
for the user's SfSIIs and SlSOOTs. The corresponding 
default SISIl and SYSOUT FCL pointers are maintained in the 
cbivt<:b. 

CHIFCL - Format Control Library entry. The FCL contains the informa- 
tion needed by the Format Control Module for handling the 
user's SYSIl/STSOUTs. This information pertains both to the 
user*s environment profile and to the actual hardware chara- 
cteristics of the SYSIl/SYSOUT mode (terminal or dataset) . 
The system contains a set of FCLs for all supported devices 
and access methods. The system FCLs also contain a set of 
system defaults for the user's terminal environment which 
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are used until the user's profile can be accessed. It LOGOl 
time the user is assigned a copj of the sfstea's FCI,. After 
LOGOM has completed , the user's own environnent profile is 
merged with the device regniresents and limitations and is 
contained in the FCL. 

CHITEEl - terminal ILH to PCL translation entry. There is one CHA~ 
TEll entry for every assigned ILl whether its for an ETIl 
or non-lTII terninal. The ClITEll entry contains pointers 
to the FCL(s) used to define the SYSIl/SYSOOT connection 
between the BLl and the user. Ilso maintained in the TlBl 
entry are the completed work flags for use by FIIBQ when 
running an MTT application program* 

CHAGll -- 61 Tl ma€:ro parameter list. All of the TAIII macros build a 
fixed length format parameter list. This macro parameter 
list is described by the dsect CHAGHA. 

TAHII COITIOL BLOCK 0BGA1I2ATI01 



fTSS - Pser Hacro to SYSIl/SYSOIIT Translation 

Each user (see Figure 11(A)) connecrted to a tmsk is allowed a maximum 
of three SfSOOTs and three SlSIIs active at any one time. One SISOOT 
and one SfSIH are considered the default component. Each of these 
SlSOOT/^ISIls are described by a FCL entry. There is only one FCL for 
each device connected to the task. An FCL entry may describe only one 
SYSOOT or one SYSIM or it may describe both a SYSOUT and a SYSIl for the 
same device . 

then the application program or the TSS Command System issues a TAIII 
macro, the user and the component for which the reguest is directed is 
specified using the OSM, CPO and/or CPI parameters. If the USl and CFO 
and/or CFI are not used, a FSl of (the task owner) and the default 
components for that OSV are used. Using the USl number, C2FTA computes 
a pointer to the user entry in CHBITT. From this entry C2FTA picks up 
the pointer to the user's TTCB which contains the pointer to the FCLs 
for the user. If a CPO or CFI had been given, CZFTA uses it as an index 
into the list of SYSIl/SYSOUTs owned by the user. If not given, C2FTA 
uses the default pointer from the VTCB to get the correct FCL. 

VTSS - BTAM Interrupt to FCL and fTCB Translation 

Bach interrupt from BTAl (see Figure 1# (B) ) which is received by the 
task's ETAH Interrupt Processor (CZFTB) contains a half word number 
called a ILl - lelative Line lumber. The BLl is used by C2FTB to index 
into a table of »term' entries pointed to by CIBITT. The TEBI (CHATEfil) 
contains the user number psi) of the user owning the terminal and poin- 
ters to the FCLs for input and output. If needed, the ¥TCB address is 
loaded from the associated FCL. 

BTAH - Virtual Hemorv Bequest to TCT Translation 

then ¥TSS sends an I/O reguest to BTAl (see Figure 15(A)) by execut- 
ing the ATCS S¥C, ?TSS fills in the field ATCSBLl from FCLBLl. The BLl 
is used by BTAl to determine the device to which the reguest is 
directed. 

Upon receipt of the reguest, BTAH picks up the BLl from the parameter 

list. If the BLl is zero, BTAl assumes the reguest is for the task 
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Figure 1«l. TIHII Control Blocks -- WTSS 



owner *s terainal and loads tlie TCT pointer from tlie TSI* If tlie Bill is 
non-zero, IT AH ms&s tke RLl as an index into a list of fullwords pointed 
to bf tlie task's TSI. Tlie first halfvord is a set of flags and the 
second half word is the SBl of the deirice* The SDA is used to compute 
the address of the scan table entrj , fron which the TCf address is 
loaded • 



BTAB - I/O Interrnpt to Owner's Task TSI Translation 

Whenever RTAH receives an I/O interrupt (see Figure 15 (B) ) , the 
interrupt 6QE contains the SDA of the line* ITAH uses the SDA of this 
interrnpt, to conpnte the scan table entrj • In the scan table entrj is 
a pointer to the TCT for the line. If there is not a TCT pointer, ETAl 
assnnes that the interrupt is an initial interrupt froa a user who wants 
to connect to TSS. In this case, ITAl allocates a TCT and places its 
address in the scan entrj • If there is a TCT pointer, BTAH tests the 
TCTLOG flag. If the flag is on, the terninal is in the logon process so 
there is no task and therefore no TSI pointer. If the flag is off, BTAH 
loads the TSI pointer from TCTTSI • 
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Figure 15. TIIII Control Blocks - ETAl 
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issues an I/O request (see Figure 16) , If AM builds a re- 
called CHABPP (BFP for short) and moves all the pertinent 
and data out of virtual memory and into the BFP. The BFP is 

pending request chain of other BFP blocks. This chain is 
y order- Iny request which has the break flag (GllBSK) set 
o be a top priority request and is chained at the top of the 
e. Following these requests are the normal I/O regeusts is- 
ual memory. At the end of the request queue ^ are the Soli- 
er Command Bead operations. 



ETAl builds a channel program for a BFP in a control block called a 
Terminal I/D Control Block or TIOCB (CHATIO) . The TIOCB is not con- 
structed for a BFP until it is time to do the actual I/O. When the 
TIOCB is built the BFP is pointed to its associated TIOCB and the TIOCB 
is back pointed to the BFP. 

then the TIOCB is activated by initiating the I/O, the TCT for the 
device is updated to point to the TIOCB. The pointer TCTTIO should 
always point to the current active TIOCB if there is one. 

RTAii I/O Chaining 

STAM supports chaining (see Figure 16) of active I/O channel programs 
through a TIC and PCI interrupt operation- Any channel program which 
can be chained from is ended in two »0-0P CCWs and a pointer is set in 
the TIOCB to point to the second lO-OP which will become a TIC CCl. 
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IheB a TIDCB is added to the active I/O chain and is to be chained 
to, the second lO-OF of the previous flOCB is changed to a TIC CCl. The 
TIC-to address is the address of the start of the new channel progras 
and the second fnllword of the TIC CCl is the address of the TI0CB being 
TICed to. When the set np of the TIC CCW is complete, the cosnand 
chaining flag is set in the first HO-OP to activate the TIC CCW. 

The reason for two lO-OPs is to allow chaining as late in the active 
channel program as possible. If the ending I/O transfer CCW were ns^d, 
it would lengthen the *!iiss window' by the aaonnt of tine it takes to 
transfer the data. In this way the window for nissing is only the a- 
mount of tine it takes the channel to process the HO-OF CCW. 
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figure 16. TAHII Supervisor I/O Queues. 
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I MCF SUPPQR1? FOR TSS 

The NCP facility of TSS provides support for a channel attached 3704 
or 3705 Comaunications Controller , executing either the Emulation Con- 
trol Pro gran Level 3^ or the letwork Control Prograa/?S Level 5. 

The following SMI devices are supported as TSS systea SYSIN/SISOOT 
components: 

376 7 Display Unit aodels 1^ 2, and 3 

3277 Display Onit aodel 2 using a 3271 Control Unit model 12 or 
3274 Control Unit model IC using SDLC 

3278 Display Unit aodels 1^ 2|. 3 and 4 attached to a 3274 Control 
Unit model 1C or a 3276 Control Unit model 11, 12^ 13, or 14 

using SDLC 

The following 3270 class printers using either 3270 data stream or 
SHI character string (SCS) data streams are supported: 

328 4 models 1 and 2 

328 6 models 1 and 2 

320 7 models 1 and 2 

328 3 model 2 

328 9 aodels 1 and 2 

TSS NCP support allows the operator to activate (load and execute a 
•bring up" seguence) , deactivate, and dump a 3704 or 3705. The operator 
or an authorized user can run a line trace against an active SDLC line 
or an active 370X Communications Controller running iCP/¥S Level 5. 

ISSIGIIIG HCP CIPIBILITI TO TSS 

To support the ICP on TSS there are two new parameters added to the 
CLOP macro instruction -- SUBJkRSl and MAXSUBI. If they are not speci- 
fied, TIKII's HCP function is deactivated and an error message will be 
given whenever an NCP activation is attempted* 

MIXSUEl is the maximum number of subarea numbers to be assinged in 
the network. It is specified as a decimal number which is a power of 
two, minus 1 (e.g., 3, 7, 15, etc.) but not or 1 ; subarea values of 

and 1 are reserved for T&EII. 

SUBAREA is the number to be assigned to RTAM as its subarea address 
value. It must be greater than zero and less than MAXSUBA. A value of 
1 is recommended for use with HCP Level 5. 

TSS Restrictions for BAISDBA and SUBAREA 

TAMU considers the SDA to be a network address belonging to subarea 
0. Therefore, the number of bits used for a subarea number must leave 
enough bits to accommodate the installation's largest SDA* 

TAMII restricts the number of minor nodes belonging to a subarea to 
512 or less. This is due to the size of the tables moved to the super- 
visor and the nechanism used to move the tables. The recommended value 
for MAXSOBA is 127 which allows the full 512 elements per subarea and 
128 subareas. It also allows SDA values to X»1FF». 
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I DEFIHISG m MCP FOE TIIII 

I Not all of tke iaf orMation eroded in the ICP aacro instructions is 

I used bf both TIMII and the ICP generation routines. However ^ all of the 

t sacro instructions should be coded with the possible needs of both !MHII 

I and NCP generation in Bind. 

I The following is a description of the aacro instructions and their 

I paraaeters; soae are HCP and TAHll paraaeters, and soae are for TAHIl 

I only* (Eefer to the SYSGIH for MCP aanual r IBM Order Huaber 
GK:30-300 8-5.J 

I Mot e: there aust be no discrepancy between the source used for the 
I MCP generation and the source used for the TSS MCP table genera-- 
I tion; the sourire can be used for both generations without 
f aodification* 



I The PCCO aacro 

I &aTODMP={XlS|MO} 

I specifies whether , after an unrecoverable failure of the coaaunica- 

I tions controller or the MCP, a duap of the coaaunications controll- 

I er storage is to be taken prior to an automatic relPL (i.e., 

I IOTOIPL=YES) . If IUTODHP=MO and I!ITOIPL=YBS the MCP is relPLed; if 

i AOTOIPL=NO also, the MCP is deactivated and reaoved froa the 

I sf s tea • 

I 1II«K)IPL= CYlSfMO) 

I specifies whether after an unrecoverable failure of the MCP or coa- 

I aunica tions controller and after the duap (if one is taken) , a 

I fresh COPY of the MCP is to be automatically loaded into the coaau- 

I nicatlons controller and restarted* If I0T0IPL=10, the coaaunica- 

f tions controller is deactivated and reaoved froa the network. If 

t the coaaunications controller is successfully reloaded, configura- 

I tion restart atteapts to return all resources to the state prevail- 

I ing at the tiae of the failure. Eowever, all tasks will have been 

I disconnected and abended. Ill dial coaaunications will have to be 

I redialed. 

I AOTOSIM=MO 

I TAHII does not support auto-synchronizing. 

I IMItlSf=MO 

I Tie II does not support the initial test routine load. 

I The rest of the PCC0 paraaeters are ignored by TIMII* 



I The BPILD aacro ; 

I OLT=MO 

I TIM II does not support TOLIP. 

I HIXSUBI==n 

I discussed previi^ttsly. Code ilIXSIIBI=3 or greater. The MCP default 

I value of zero amst not be used . Ilso, HIISUBI value should be the 

i saae for all MCPs and the TSS STS61M. 
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I 'ghe HQSf macro: 

I Wkea coding the following paraiieters, note the restrictions placed on 

I their use by TIMII. 

I BF1PID=0 

I TIM II requires zero and does not support leading pad characters. 

I 11 XBFRO= count 

I specifies the number of buffers that the host processor allocates 

I for each data transfer (channel program) received from the local 

I communications controller- 

I lJlIfSZ=length 

I specifies the length of a host processor's buffer- For TkETX, the 

I value of KIIBFBO multiplied bj the value of OHITSZ must be 4000 or 

I less. Hecommendation: MIXBF1U=B and UNITSZ=256- 

I STITHOD= pESfMO} 

I T&III supports either value, lecommendation: STIT10D=I1SS. 



I The GBQOF> LIME^ PD and LU macros ; 

BOPLIM=n 

the number of 64 byte blocks BflE will allocate to hold the trans- 
missions to be sent to a specific LO; •n» is a decimal number from 
to 256* 

ISTATUS= {ACTIVE | INACTIVE} 

specifies whether a node is to be ACTIVE or IlICTIVB when the "own- 
ing • node is made ACTIVE. 

Example : for an ICP gen such as the one shown immediately below, 
the ISTATOS shown in parenthesis is the assumed value; whenever 
ISTATOS is not specified for a node, that node assumes the ISTATUS 
value of the • owning • node: 

(IST1T0S=ICTIVE) 

(ISTATOS=IHACfIVE) 
(ISTATUS=ACTIVE) 
(ISTATOS=ICTIVE) 
(ISTJkTUS=&CTIVB) 

In the example above, when the MCF is activated, TAMII will also activ- 
ate the following resources: IISE-Ll, Pll-P2,L0-021 and 10-1122, because 
each higher level "owning* resource has also been activated. PU-P1 , be- 
cause its ISTATIFS=INACTIV1, is not automatically activated and therefore 
its LOs are not activated even though LO-Oll has ISTITUS=ACTIVE. Mow 
when the operator activates the PU-PI, then TAMII will also activate the 
LO-011, but not Lll-012 because its ISTATOS is IIACTIVE. 

With TAIII, ISTATUS =IS ACTIVE means the resource must be activated 

by direct operator command- 

MODETAB=device type code 

lODBTAB on an LO is used by TAMII to specify the type of device the 
LO is; only the following codes are accepted: 
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GROOP ISTATOS=ACTIVE 


LI 


LIHE 


P1 


PO ISTATUS =IN ACTIVE 


Oil 


LU ISTATOS=ACTIVE 


012 


LO 


P2 


PO 


021 


LU 


022 


LO 



TNL GN204106 (01 July 80) to GC28-2008-5 

3278 3284 3287 3277 3767 3286 3289 3288 

irPACIiG= {(Q[ ^m]) 10} 

defines the waj T&IIII and the ICF are to pace the flow of iata be- 
tween the host processor and the NCP for sessions with the associ- 
ated logical units. 

n -- specifies the number of messages that TIfll is to send to the 
HCF bsfore waiting for a pacing respo^nse; 'n" is a decimal nmaber 
betwe'^n 1 and 255 and aust be egnal to or greater than the ¥alue of 
the •m" used with the ICP's corresponding PacillG paraater. 

c — specifies which of the •n* {the paraaeter above) requests will 
be flagged to request a pacing response from the iCP. TARII sends 
at Bost^ n-n additional data reguests if a pacing response is not 
receired. If •a* is not coded r •n* is assnaed*. Specify *ii» as a 
deciaal number between 1 and "n", and Bust be equal to or greater 
than the value of •m" used with the PACING paraaeter. 

-^ specifies that no pacing is to be performed for sessio^ns with 
logical units associated with the aacro instruction in which VPAC- 
ING is coded. 

Defining tae KCP Setwork to TABU 

The telecommunications network is defined to TAKII by preparing and 
assembling definitions of the two types of major nodes and then filing 
the object modules in joblibs owned by the operator. 

The two types of major nodes supported by fAEII are: 

!• iCP major node 

2. S'iitched SNA major node 

An BCP iiiajor node consists of a 3704 or 3705 Communications Controll- 
er (locally attached} , the network control program (SCP) being executed 
in that controller, and the physical configuration defined tor that ICP 
during NCP generation. 

Switched SIA major nodes consist of either or both of the following 
supported SUA terminals: 

376 7 Communications Terminal 

3274 or 3276 Display Controllers and Displays 

Switched SNA major nodes do not include the switched SDLC links to 
which the terminals are attached (these lines are part of the MCP major 
node) • The minor nodes of a switched SUA major node are the SUA con- 
trollers aiad their associated logical units. 

Any number of definitions can be prepared, assembled and filed, to 
represent combinations of major nodes that may be desired in an active 
network under different circumstances- lach major node definition con- 
tains statements defining all minor nodes encompassed by the major mode. 
Each major node must be assigned a unique name and must have an entry in 
the TSS*****.SYSBCS dataset (discussed in detail later) in order for 
TAHII to b<i able to use the major node. 

Defining tite MCP and Remote Terminals 

One or iiore lI'CPs for each communications controller must be generated 
and stored in a joblib. The source deck used to create each 21 CP is then 
assembled using the TSS macro libraries. The object modules created by 
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I assemblies ar^ st..c»red ia either the same joblib or a different one froa 

f the HZP l.otiu aioduies. The information as to what is stored^, and nhere 

I it i<i i;i: ore^r i.*^ coBatined in the 5YSRCS dataset in the regioE whose 

I name is the same eis the resource name. The oame assigned to the region 

t that cotttaias tiiese definitions is the name bf which TIIII will reco- 

I gtiize tii «:■' I^CP. 



I MLLM.M ,., Switched ^ S U A M a j o r Mo des 

A switched Slii aa^or node is defiEed bj a single BUILD macro state- 
lent for zhe. major node and separate PD and LU stateaents 'lor each ainor 
node. (U]e BCILB macro with TYFGEII=S'^Sj5T aust be included in each source 

dataset^ i^xaced before the first PU aacro* The BOILD macro assigns a 
sabarea value to the major aode for TIHII^s use in assigning addresses 
to the iiir4i.rr nodes. 



the v b an 
by swii-c £i<./!i 
to 'ieti!i»'« -i 



d TiO macros define physical units and logical mEits attached 
TiLk. lines. The PO and LO macros are the saiae as those used 
C? Gtaior node. 



li\e i ]i;:xaIlatioii may define aultipie sets of switched SPA de¥ices. 
This aiiowi-, the network operator to selectively activate a subset of all 
the snitched SUA devices using the aCTIfATE coRiiaand. However, all najor 
ana amo.r rioce names 'fcnowii to TAMII at any one tine i*ust be aEigue. 

It ctmtnct. is to be established with a physical unit by means of a 
^dial Ib • i>iH''£'itiiji\ y the unites station identiiication Busber Enst be 
placed if! tae SYSRCS region called BIECflAMEi. folloMed by the physical 
unit* .s r e .-;o i* r ce iidme in the f or s a t : ® 

* uva jO£ node name. physical unit name* 

kheu tlie i-.hysical unit dials in, TIrtll searches the SISP.CS region 
islKCNkf't loo/ciFivf for the statioa id. If found, the physical unit's name 
is retri-vecl an J if needed, the aajor node coataiaing the definition is 
activated :idtoaatically . The inf oraation from the physical unit defini- 
tion i'l t'leB ^i.;::ed to cofi«plete the connectioii orocess. 

The iiii.it *s station j.aentif icat ion liuber is a 48 bit number which is 
unique ioi: >::r,-::.i station wichin the network (not just within the major 
no'ie'i « ?;)73 .station iil is structured as ioliows: 

y...„ _^ . — _^_«_ — «_ — ^ — _-_™ — ^«>_^ — ___ , — ^_-_ — ^ -.^ ^ — ___-_ —^ J 

I X»0» IPIJTYPEI X»00» I IDBLf: | IDNUIi | 

I -..- -...i. „._._.,._,_.. ....l^-_-_«._______ _L - .. . .^ — ™L, - . _- _. . . —I 

bit U 3 16 28 ^7 

POTYPE - the physical unit type as follows: 
376? - 1 
3 27«4 - 2 

I i')'iL;\ " the 12 bit binary block niiaber assigned by IBM to the spe- 

f c-4_:i:.ic aevice 

I LD.iil^ ■" the 20 bit binary identification number assigned to the 

i station being defined. 
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I OBGIHIZIflOH OP Tlill HCP/SII SOPPOlf 

iMie T&HII ICP/Sil support consists of three groups of modiiles.. fke 
first group consists of tlie user iaterfact routines. These routines 
convert the user*s requests into control requests for the MCP. The 
second group reside in the virtual memoTj portion of TIMII and consist 
of two routines. Dne^ CZ&FTII^ is the MCP network path translation rou- 
tine. The other routine is the FCM used bj the user control modules to 
comnunicate with the MCF control routines residing in ITM and the MCP. 
The third group of nodules reside in KTiH in the resident supervisor. 
These bo doles control all coanuni cations with the MCP and any supported 
SMA devices. 

When a TSS MCP gen is perforsedr a set of tables is created which 
contain the definition and path information for the MCP. Is part of the 
KCP activation process these tables are read into shared virtual nemory 
and are used to fulfill the function of the SDIT (CMS0&) in virtual 
aenorf and the scan table (CHISCH) in real core. The virtual meaory ta- 
ble (CHAMII) is cajLled the minor node table — lllli. It resides in 
shared virtual memory and is connected and disconnected as needed. The 
real core table is called th Resource lesolution Table — (CBARRl) • It 
is read into virtual memory by the active process and moved to real core 
upon execution of the ADSBl — Idd Subarea S?C (discussed later in this 
document). The EBl is used by BTIH to control the activation^ deactiva- 
ticHi, and allocation of the MCP network resources. 
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As an NCP is activated r an entry is aade into tlie Node Active Table 
— NAT. The NAT is a dictionary maintained by the NCP user interface 
Modules using the dictionary handler CEASB. CHBNAT is an I¥E control 
block which contains the RSPI nusber and other information needed to 
connect and disconnect the NAT dictionary* When an NCP is activated a 
■a^or node entry — UN CCHAIIJN) is built in the NAT dictionary- The 
UN and RIR are read into memory and a pointer^ in RSPI format, to the 
KIN is placed in the MJN entry. 



I Using a TAKII OPNBST the NCP is connected to TAKII and the device is 

I allocated to the task* With the completion of the OPNBST the system 

I control blocks are setup to perform the activation function for the NCP. 
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The activation function consists of tke loa^ding of tke 3701 with the 
specified iCP load aodule and the activation of the MCP and its re- 
sources using the appropriate SHI coMBands. 

TAKII Format Control Eodiile Sapport for the ICP 

CZfSSCP is the name of the Fomat Control Module used to support the 
ICP. It validates and handles the special TCITll type codes used to 
communicate between the virtual memory user control modules and the ETAH 
SSCP control module. CZFSSCP also contains special entry points for 
handling error records^ line trace records ^ and dial in records returned 
by the MCP- 

formal read and write operations are not used or supported by 
CZFSSCP.! Any attempt to use these requests results in a nonsupported 
CX»20») return code. 

MCP PATHFIIDIIG SUPPOET COITBOL BLOCKS AM0 HAMDLEB 

For MCP Eesource Resolution or as referred to in TIKII, ICP Pathfind- 
ing,. there is an integrated set of control blocks. These control blocks 
all reside in shared virtual memory and except for the CHBMATr header 
control blocks are disconnected when not in use. There are three con- 
trol blocks used by the NCP modules in virtual memory. Except for 
CHBHATy the control blocks are built by the ICP/TSS gen process and are 
loaded from datasets as part of the MCP activation process. The three 
control blocks are CiBNAT^ HJIr and HIl. 

CHBMAT is the anakor for the MCP control blocks. It is loaded as 
part of IVK and as such is addressable by all tasks in the system. 
CHBIAT contains system dependent MCP values such as the maximum subarea 
value^ the subarea mask and the subarea shift value. CHBMAT also con- 
tains the anchor for the rtJN dictionary. This anchor is in the format 
SSPI, 1PM and page count, and is used whenever a task has to connect to 
the dictionary. Included in CHBIAT is the HJl lock word which controls 
access to the MJll dictionary. 

MJM — major node entry — is a control block which describes the MCP 
control program to TllII. It is built from the contents of the BUILD, 
HOSTr and PCCU macros used in the gen of the iCP load module. iJl also 
contains information needed by the lESTAlT and BUMP commands. The MJM 

entry resides in 'a control block called the HJN dictionary. When the 
ACTIVATE coBuiand for the NCP is issued, a IJM entry is built and placed 

in the dictionary using the dictionary hanler module CZASD. Afterwards, 
the MJM entry can be retrieved by calling CZASD3 with the ICP name. The 

MJl for the ICP contains the address of the genned resources owned by 
this ICP — the KIM table. This address is also in HSPI, EPIl format. 
The MIN lock word is kept in the IJl; this lock controls access to the 
IIM. 

The HIM — minor node table ' — is a gen created table of all re- 
sources owned by the subarea of the MJl. This table is basically the 
SDAT for the MCP or other subareas. There is one KIM entry in the table 
for each s:iA resources defined in the MCP gen. A resource is the ICP 
control program (always resource 0) , a communications line (LINE) , a 
control unit on the line (PO macro) or a terminal or end user on the 
control unit (LO macro) . Each resource has a unigue name assigned at 
NCP gen time. 

The path tables, MIM and HJM, are never connected to a task except 
under appropriate locks. The JCP Deact Command Processor assumes the 

tables are not in use if they can be write-locked and are therefore a- 
vailable to be FlEEHAIIed. The MJM and Mia locks are set up like data- 
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I set IBSUBI locks. The pathfinding module CZFITH uses CZCOH and CZCOI to 
t lock and unlock the table locks - 



I 1TIlH/¥CP SOPPOlt 

The Resident Terminal Access Method (ITIM) has a set of modules that 
provide the required BCP support. The modules were added in two areas: 
system support routines had CEITP (connect device) and CEATG (connect 
resource resolution tables) added; the device control modules had the 
LU-LU session control and SNA device support added. A description of 
these new modules follows. 

System Support Routine Additions 

CEATF (allocate device) is called by SVC from virtual memory to 
allocate a specific device to a task. Its parameter list is described 
by the DSBCT CHALCH. The device address is passed to CEATF by an SDA or 
an BIB. It locates the resource entry for the device and determines if 
the device is available- If the device is available, CEATF allocates 
and builds the necessary RTAH control blocks, sets up the required 
tables and calls the Device Control Kodule responsible for the device to 
complete the connect request. Opon return from the DCM, the allocation 
is complete and CEATF returns to the task with needed device information 
in registers and 1. For device allocation failures, CEATF has a com- 
prehensive set or return codes describing the reason for a failure. 

CEATG (connect/disconnect resource resolution tables) is called by 
SVC from virtual memory to connect or disconnect the Resource Resolution 
Tables (CBARRR) which define the resources controlled by a major node in 
the SNA network* These tables are also used by RTAH for device alloca- 
tion, control block anchors and status save areas. The RRR fulfills the 
same function for the major node and RTAH as the scan table (CEASCH) 
does for TSS and RTAM: the two are analogous. For a connect, virtual 
memory (during the activation process) issues the Add Subarea S^C (dis- 
cussed later) with its associated parameter list. The parameter list 
contains the subarea address of the RRR which was previously loaded by 
the task and the count of entries in the RRR. CEATG validates the re- 
quest and the subarea, allocates supervisor memory, and moves the RRR 
tables to the supervisor. For a disconnect, virtual memory issues the 
Add Subarea SVC with disconnect set, and the subarea address. CEATG 
checks the RRR before releasing to make sure it is currently not in use 
and if available, releases the supervisor copy- 

Bevice Control Modules 

CEDMOB fulfills two functions- First, it sets between the DCM»s ini- 
tiate request entry points and RTAH, to standardize the calling inter- 
face with the entry conditions expected by the other BCM entry points so 
that the RTAM work queue dispatcher is presented with a common interface 
across entry points. 

The second function provided by CEBMOB is a primitive work queue ing 
and dispatching mechanism for gueueing work between different TCTs. 
This avoids the multi-cpu locking problems which would exist if one 
attempted to lock more than one TCT at a time. 

CEDOBQ is the enqueue entry point. A TCT and buffer address, along 
with a queue number, is passed to CEDOBQ by the calling routine. The 
buffer must not be chained on any TCT at the time of the call. CEDOBQ 
enqueues the passed buffer and TCT on the requested queue and returns. 
It is the dispatcher; it is called by CEATA, CEATB, and CEATD just be- 
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fore returning to tkeir caller. It searckes the guemes for work follow- 
ing these simple rules: 

The gueues are processed ±u a FIFO order froa gmeue 1 to gueme 7. 

CIDOBJO does not love froa one gueue to the next until all work on 
the guene has been processed • 

If the fCT to be dispatched to is locked, CEBOBD leaves the re- 
guests guemed, and exits. 

ClDlOB contains the guene headers, hard coded in the back of the 
aodnle; there are s«iven gnenes: 

Queue 1 is for error recoverf ; it has the highest priority. 

Queue 2 is not in use. 

Queue 3 is used for posting write completions. Queueing on the 
gueue results in the buffer being sent to the write coapletion 
entry point of the 0CH responsible for the TCf . 

Queue 4 is used for posting read completions. Like gueue 3 the re- 
sponsible DCM'B read completion entry point is called. 

Queue 5 is used for reguesting initiation of a function, iork for 
this gueue is sent to the initiate reguest entry point of the DCl. 
This is the saiie entry point that processes SfC reguests froa a 
task. 

Queue 6 is usecl for reguesting I/O initiation. Eeguests gueued 
here are sent to the DCi responsible for transmitting and control- 
ling the I/O interface. 

Queue 7 is the lost path and/or resource forced disconnect re- 
guests. These are processed last to ensure that all other reguests 
destined for the lost resource have been reaoved froa the gueue - 
Iny reuests on gueue 7 are sent to the BCM's error recovery entry 
poi nt . 

CBD37X1: handles the I/O channel interface for all 3701 type devices. 
It is set up to interface to the I/O side of ITIM and is called by CBI.T1 
on I/O interrupts from the 370X device. It is gueued to by the MCP con- 
trol aodules CIDSSCP and CSDLOCP whenever they have output to be sent to 
the 370X control program. 

CBB37XX contains the routines used to load local 370X control pro- 
grams. These routines handle the NCP or the EP program. 

CIDSSCP is RTIK»s system services control point module for contro^l- 
ling the TSS/SII network. CIDSSCP handles all network control functions 
including the activating and deactivating of all network resources. It 
oversees all connections and disconnections of LUs with TSS and handles 

all network error recovery, recording and restarting, if reguired. 

CIDLOCP is the RTIE LO-LO session control module; it handles all SUA 
protocol reguireaents needed for the support of the LOr-LO session. It 
is device independent and relies on a sublevel of DCMs to handle the 
device dependent data manipulation reguireaents. CEDHJCP only supports 
the following session type: half duplex flip flop data flow within 
brackets . 

CBD3271 is the device dependent DCE used by CEDLOCP to support remote 
3270 devices; it handles all 3270 device functional reguirements imposed 
by the SUA 3270. The corresponding DCL is CEDI.701. 
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I &BSBA — Md/Delete Siibarea SVC fS?C212l 

The I.BSBI SVC is used by the virtual »0»orf ICP activate ant deactiv- 
ate routines to move the required subarea tables to the supervisor* 

The ABSB& SVC parameter list is described by the BSICT CHUDSB. 

The following codes are returned to the task in the task*s general 
register 15 after execution of the SVC. 

Code Explanation 

X«0« successful add or delete 

X«ft« subarea to be added already exists 

subarea to be deleted does not exist 
X«8* subarea to be deleted is still in use 
X«C' invalid parameter list; SVC not executed; SVC parameter list 

not on doublevord boundary , or VRA for parameter list does 

not exist 
X*10" subarea number is invalid; subarea number is 0, 1, or 

greater than the maximum subarea number allowed 
X»14» unable to allocate space to hold table 
I*18» the REE header is invalid; the count of entries or the 

subarea number does not agree with the IDSBA value or 

the subarea mask value is not the same as the sysgened 

value 

LCOMll — Connect TAMII Terminal SVC Eecinest CSVC205I 

The LCOIN SVC is issued by the TIIII virtual memory module to cause 
ETIH to allocate and bi|ild the necessary tables to connect a TIMII 
device to a task* 

The LCOIH SVC parameter list is described by the BSBCT CHM-CK. The 
SVC must be at the head of the parameter list and be executed. The pa- 
rameter list must start on a full word boundary. 

The I. com SVC processor returns the following information to virtual 
memory in registers and 1: 

Register — 

byte — zero 

1 — device type code from TCTBTI 

2 ~ zero 

3 — the Device Control Nodule index for the device 

Register 1 — the relative line number in bytes 2-3 by which 
RT&l knows the device 

The LCOHli SVC processor returns the following codes in the task*s 
register 15: 

Code Explanation 

X«0* LCOm request was successful 

X*i|« device is in use by the system 

X*8» device is in use by WtkE 

X*C* device is not an RTJLH device 

Xtto* resource entry for path is in use 

X'14* subarea has not been activated 

X»18» invalid SPA or RIB given 

xnc» EIB from LCHRIB is invalid 

X*20* no space available for TCT 

X«2i|* unable to allocate relative line number for device 

X«28* not used 

X«2C« invalid I.CE parameter list 
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I fSS***** • SI SICS DATA SIT 

to activate aaj resource — ICP^ PIP^ El?, etc. — this lataset aust 
exist « 

lach region in tLis dataset will kaire tke saae nase as the resource, 
and will contain inforaation tkat pertains to tke particular resource. 
Any resource information tkat is not defined in tkis SYSRCS dataset must 
be included as parameters in one or aore of tke ICP coaaands (discussed 
later in tkis section), witk one exception; !PYPE= must be defined in tke 
SISICS dataset; it is not a paraaeter of any of tke ICP coaaands. 

Iny parameter entered by tke system programmer in any ICP command 
will override tke saae parameter if it is predefined in tke SYSICS data- 
set for tkis resource. 1 lis^ of tke paraaeters tkat may be predefined 
in tke SfSfiCS data set is as follows: 

TyPE= 

identifies tke resource to TSS; specified as HOP, PEP, SP, or a 1-6 
ckaracter name C^ke first ckaracter must be alphabetic) supplied by 
tke installation - 

I>SIIAME= 

specifies tke name of tke dataset from wkick tke resource load 
modules will be taken. 

SUBfIPB= 

identifies tke type of kardware tkat will be used for tkis 
resource; i.e., 370«», 3705, etc. 

M11I1IA1E= 

tke name of tke load module wkick contains tke tables tkat will 
describe tke resource to TSS- Tkis parameter does not apply to an 
EP. 

LOADIiIM= 

tke name of tke final load module that will run in tke resource. 

P1&SE1= 

tke name of tke initial load module tkat will 'bootstrap* in the 
second phase. 

PHASE2= 

tke name of tke second load module, called 'tke second phase", 
which will read in the final load module. 

HOUTIliG= 

describes the different routes that can be used to get to the 
res ource • 

PCL= 

the name of a T&EII control table that contains detailed informa- 
tion concerning the fAHII interface to this device. This table 
will contain the current status of the device • 

1BSTABT= 

tells TSS whether or not to perform an automatic restart if an 
error condition should occur. 

AOTDDMP= 

tells TSS whether or not to perform an automatic dump if an error 
condition should occur. 
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I DEPPH1= 

I tke naae of the initial load module that will be used to •boots- 
I trap* in tbe final dump load module. 

f DHPPH2= 

I the naae of the final dump load module- 

I DOMPDS= 

I the name of the TSS dataset that will contain the dump output - 

i The SfSlCS dataset may be edited using the TSS Editor* The TSS data- 

I sets that must be available in order to activate an ICP are DSIiIIIl= and 
TSS*****.SfSRCS. 



I ACTIVITIOI OF IN NCP/PBP 01 BP 

I The activation of an ICP /PEP or EP entails the transfer of particular 

I load mc^ules froB the TSS system to the ICP/PEP or EP, and the activa- 

I tion of those load modules in the resource. In order to perform this 

I function certain types of information must be available to the TSS sys- 

I tea. Each resource that is to be activated has some information that is 

I unique. Ictivation of the resource is initiated by the ACTIVATE 

I command. 



I DBACTIfATIOM OP AM ICP/PEP OE EP 

I The deactivation of an ICP/PEP or EP entails the severing of communi- 

I cations between TSS and the resource. In addition, all tables read in 

I and generated during and after the activation of the resource are 

I deleted from the system. The region in the TSS*****.SYSRCS dataset of 

I the same name as the resource, will be scanned to determine the type of 

I resource being deactivated as the deactivation processes differ. 

I DOEP OF Ai MCP/PEP 01 EP 

I The dumping of an ICP/PEP or EP causes two load modules to be sent to 

I the resource. All activity at the resource ceases, and in order to run 

I again the resource must be activated again from scratch. The DUMPIES 

I command causes the entire storage of the resource to be written in the 

I output dataset. 

I AUTOMATIC DUiPIMG AMD EISTARTIHG OF AW NCP/PEP OK EP 

I If an error condition occurs in the resource, the TSS system will go 

I to the appropriate region of the TSS*****.SYSBCS dataset and check the 

I AUTODMP parameter. If AOTODMP=Y is specified, the TSS system B.ust find 

I the DMPPH1, DHPPH2, and DUEPDS parameters in the region. If all are not 

I present, or if AUTODI!P=N or if there is no AUTODMP parameter, the TSS 

f system will bypass the automatic dumping of the resource and process the 

I automatic restart parameter. If RESTART=Y is present in the region, the 

I TSS system will attempt to reload the resource by going through the 

I entire load process. 

I TRACE OF AM ICP/PIP 01 EP LIHE 

I The tracing of the data transmissions of a particular resource line 

I will be initiated by the TRACE command. The data will be sent to the 

I TSS system and then recorded in a dataset for later processing. 
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SPECI&L CQMMIHD FICILITIBS FOR SYSTEM KQWITORS 

The systea prograiaaer with the privilege class E (sfstem monitor) can 
reserve unit record equipment for nonconversational tasks (via the SB- 
COfiE coa&and) and symbolically refer to specific devices (via the DDEF 
coamand or sacro instruction) « In addition, he can use extended PlIHT 
cx>attand features, which enable hi® to have a data set — previously re- 
corded in the Aaerican national St^andard Code for Infornation Inter- 
change m AiSI X3i**-19i58, referred to herein as ASCII — read in froa tape 
and printed out* This lets the TSS systea programmer verify an ASCII 
tape that could have been produced using some other systea* 



lESEfiVIMG I/O DEVICES fOl A HOMCOHfEHSATIOlAL TASK 

When reserving lyl) devices for a nonconversational tasli, a programmer 
with pnvHege class E can designate unit-record eguipaent in the 
operand field of the SECOHE command- In addition to the options: 

(TA=nuaber of dev ice s[ , type of device]) 

{DA=number of devices[ ,type of device]) 

shown in the description of the SBCORE command in Command Svstea Oser's 
Guide, you may ask for one or more printers, card punches, or card 
readers by specifying one or more of the following operands when using 
HSAl or lOlEQ: 

{Pl=number of devices) 

{PC=number of devices) 

(ID^number of devices) 

where the number associated with Fl indicates the number of high-speed 
printers you require,, the number associated with PC indicates the number 
of card punches, and the number associated with ID indicates the number 
of card readers • Th€i number of devices must be specified as a one- or 
two-digit decimal number. 

If you want to reserve two printers and a punch, for example, in ad- 
dition to three tape units, all for nine-track 800-bpi tape, and one 
3330 disk drive for a nonconversational task, you might write: 

SBCOIE CBE=2) , (TA=3,9D2) , {l>A=1, 3330) , {PC=1) 

Bote that the operands need not be written in any particular order. 

Because SECOIE is defined to reserve ••any available device of the 
specified type**, it itust not be used when the task requires some partic- 
ular device (by symbolic device address) of that type. 



DBSIGHAfllG I/O EQUIFlElf 

ihen you have been joined with privilege class E, you have several 
options in the operand field of the DDEF command (and macro instruc- 
tion) , and DCB macro instruction, that are not shown in Command System 
User's Guide and Assembler User Macro Instructions . Except for these 
options, which are described in detail here, the parameters you may use 
are those shown in an appendix to each of those publications. 
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Symbolic De¥ice Address 

One of the options available to jou, as a system programmer witli 
privilege class E, is to designate the I/O device joii want to mse by its 

symbolic address. This can be accomplished by entering 

, 0»IT=sda 

in the operand field of the DDEF command or macro instruction, where sda 
is a one-to-fonr-hexadecimal digit symbol (from 1 to 7ffF) assigned at 
system generation to the I/O unit as its symbolic device address* By 

choosing this option, yon can designate a particular terminal, a partic- 
ular nnit--record device (for MSIM or lOllQ programming} , or a particular 
tape drive or direct access device (for BSIH, lOlEQ, QSll, or ¥A1 
programming) . 

DBEF by SBI is executed without regard to device reservation via ei- 
ther SECURE or lELEASE -.•,H0LD* When a specific device is to be used 
(regardless of type) there should be no attempt to SECURE it, and RE- 
LEASE should always specify the SCIATCI option* 



I VAl Data Set Allocation on Prums 

A user with privilege class G (and only such users) can initially 
allocate a data set to a drum by specifying the appropriate volume IDs 
in DDEF* The same restriction and requirement apply to expansion allo- 
cation on a drum after the initial DDEP has been released i Use of the 
SPACE HOLD option of DDfP can allocate drum space for data set extension 
by non -class G users* 

Access to an existing drum data set by a non-calss G user, or by a 
class G user who does not specify the volume ID (s) , is controlled by 
normal catalog access and sharing authorization. Expansion allocation, 
in these c^ses, is forced to disk volumes. 



PRINfllG DATA SETS 

Data sets recorded on tape in EBCDIC or ASCII can be printed in sev- 
eral formats by a class-E system programmer using the FRIIT command* 



The Printing Options 

By specifying the tape printing option (TAPOPT) with the PRUT com- 
mand, the class -E system programmer can: 

• Print an ASCII tape in character format. 

• Print an ASCII tape in dump format. 

• Examine an ASCII tape for any invalid characters, flag the®, and 

print all error records in the dump format* 

• Print an EBCDIC tape in dump format* 

Extended PRUT Command Facilities 

The basic format of the PRIIT command, when employing the extended 
ASCII options, appears below. 
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j Operation I Operands 

i 1 ^ 

IPimi? |l>Sli&MI=cmrrent data set iia»e[ rBRIiSE=EEJISB] 

I |[^lBB010Ff=pcClP1:|SKIP|E»B} [ ^P011=:paper for»] 

I I [ , TllPOPT= {IC I ID I IE I BD I EC ] 

I 1 — ^ 1 

Mote ; to enter positionallyr see the PlIMT coMaand in the Coamand Sys- 
tea User's Guide s Operands for standard PlIMT coaaand options^ such as 
Sf&RTlO^ E10»O, PRfSP/EDIT, and STkTlOM, are recognized when TlPOPf=EC, 
or the default. If included for the ASCII or EBCDIC options, thej are 
ignored. 

fhe processing and output resulting froa the TiPOPf options are indi- 
cated belov: 

IC - fhe data set, recorded in ASCII, is read froa tape without transla- 
tion to EBCDIC and the entire data set is printed in character for- 
aat. An unpriatable character is represented as a period {.) . 
Saaple output : 132 bytes in the foraat: 



. TS S*** >* .DSHAEE . . -A . . . 



AD,AE,ED - The ASCII duap (AD) and edit (IE) options, and EBCDIC duap 

option (ED) . ASCII records are read froa tape without translation 
to EBCDIC, fhe entire data set is then printed. The basic print 
record foraat for these three options is the saae, although certain 
characters in the printed output will have unique Meanings depend- 
ing on which option is selected. The basic print foraat for these 
options appears below, followed by descriptions of the distinguish- 
ing print features for each option. 

EC - loraal processing. EC is the default if TAPOPT is not specified. 

Print Foraat for AD, AS and BD Opti o ns 

Each output block consists of a header containing the record number 
and the record length in deciaal- The header record is followed by a 
data block. Each data record printed consists of the hexadecimal dis- 
placement of that data record froa the beginning of the block followed 
by the thirty-two bytes of data recorded in duap foraat (that is, eight 
full words, each separated by blanks) . The character representation of 
the data iamediately follows. 



I Head er | 

I , 1 

i record | record | 
I nuaber | length | 



^ ., ^ ^ 

I Data B lock ... ... ... | 

I ^ J ^ ^ I ^ ^ 1 

I displacement | | wordi | | wordS | | character representation | 

I 1 :! ^ 1 I 1 I . I 



-32 data bytes- 



Dist ingu ishing Features 

AD - All unprintablij hexadecimal bytes appear as periods. All ASCII 
error characters (X»1A*, or X*80* through X»FF») will appear as 
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percent signs. Error characters are flagged as sEch. Since "%•• is 
also a valid print character ^ each output print record, containing 
an error byte, is also flagged with *ERROE* appearing in the space 
between the hexadeciaal and character representations; this enables 
users to distinguish between print records containing valid and 
invalid percent signs. 

Saaple output ; 64 bytes in hexadecimal, 32 in character 

DISP HEX CHABACfSE 

0000 C1C2C3C«I C1C24040 8080ClC2*EElOR* ^BCDAB SUAB 



0020 



6C68C1C1 C1C1C1C1 



,,%.IA11IAI 



AE - Only error records are printed, rhe character representation of 

the hexadecimal data depicts valid ASCII characters as periods (.), 
a substitute character (X»1A») as an S, and an invalid ASCII 
character {X*80* through X»FP«) as an I. If no invalid characters 
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are fotmd o& the tape, the output consists of an appropriate aes* 
sage. Onlf ASCII records containing error bytes are printed. 

Sanple ontpnt i: 

0020 C1C1C1C1 11C180C1 etc. ....S.I. etc. 

IB - This option does not Include any special features. 

Sample ontpnt ; 

0020 C1C2C3C«» C1C23040 1180C1C2 1BCDIB...IB 

SPBCIAI, MACRO IWSfPCTIOl FACII>ITIgS FQH SYSTEH HQlIfOBS 

MACRO IHSTRUCTIOIS FOR MS AH 

fhere are f onr nacro Instructions that f on na; nse In yonr MSAM pro- 
grans. SBfUR enables jon to specify the nnlt-record configuration fon 
desire for on-line printers and punches. 617 and PUf provide access to 
logical recsords and nay be specified In either a acre node or a locate 
node. FiniSR Inforns the MSAM routines that a break point has been 
reached In processing a data set. 

Interruption Entry Handling 

For each of the MSAM nacro Instructions (SSTUR, GST, PUT, and 
FIIISH) , a return code of 4 Indicates that the operation has not yet 
been completed. In each case, the nacro Instruction should be reissued, 
until a return cxide other than 4 Is received. Before reissuing the 
nacro Instruction, however, you should test DCBICB and. If It Is nonzero 
Invoke the Interruption Inquiry routine by Issuing the IITIIQ nacro in- 
struiTtlon (described in Assenbler Pser Macro Instructions! to deternlne 
whether an asynchronous Interruption is pending. If so, you should give 
control to the appropriate Interrupt -handling routine and defer reissu- 
ing the MSAM nacro instruction until ijontrol is returned to your 
progran. 

BESIGIATIIG DB7ICES FOR MSAM 

In addition to the synbollc device address, three codes nay be used 
with the OMIT operand of the DBEF connand and nacnro instruction when 
using MSAM. Ion nay write: 

II1IT= {sda I PC (PR |RD} 

where sda is the synbollc device address of the desired unit record 
device, PC is a card punch, PR is a printer, and RB is a card reader. 
If you use the nultlple sequential access nethod, one of these options 
nust be specified. 
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SECflOM 5: DEFIIIIG SfSfEM HICRO IISTHOCTIQIS 



Tkis section deals with the process of defining macro instructions,, 
concentrating on precautions yon should observe and limitations imposed 
hj the various tfpes of macro instructions • It assnmes familiarity with 
the rules for writing macro definitions contained in Assembler Language > 



COlflMflQMIL fYPBS OF MACRO DBFIWITIOl 

In TSSy there are two preferred conventions for defining macro in- 
structions • These conventions define rules for writing the 1-type macro 
instruction, and the standard-^ L-, and E-forms of the S-type macro in- 
struction. In describing macro instructions for the user^ each macro 
instruction is designated an l-type^ an S-type^ or^ if one of these con- 
ventions was not used, as an 0-type f other type) * 



R-TYFE MICRO BEflllTIOl 

in R-type macro definition can be written when all parameters can be 
contained in the two parameter registers ^ and 1, The B~type defini- 
tion does not generate a parameter list but may generate constants or 
addresses. You are limited in the choice of operand forms you may allow 
the user. These forms and coding considerations are described below. 

The proper use of an R-type macro is to pass: one or two single-word 
values for 4 -byte strings) ; a double word value (or 8-byte string) ; a 
control block address and a flag word; or logically similar information. 
1 collection of data organized into a block solely for the use of a 
given macro, which has no significance beyond the ma<:xo or outside the 
using and called modules, is not a good subject for an l-type macro. 

RX Address | formerly known as **explicit** or "implied** address) 

This is an address which the user specifies as if he were specifying 
the second operand of an RX-type assembly language instruction such as L 
or LI. 

This form of address gives the user maximum flexibility in specifying 
a storage field. It permits addressing by name, addressing by base plus 
displacement, indexing, and by the effective equivalent of register 
notation as in: Of, register) . The user must remember to cover with a 
base register the symbolic addresses that may be written for this form 
of operand. A portion of the coding of a macro definition called STOR 
is shown in the box below* SAREA may be written as an RX address, lo- 
tice the preferred use of the LA instruction to provide an overriding 
base register for the STl instruction. You should not write: 

STH SREGS (1) ,SRE6S (2) ,SIREA 

The RX address form permits the coding of indexed addresses. But the 
STH instruction does not allow for indexing. So, in the example, you 
would have used the operand &IRBI in the LA instruction, which is 
indexable. 
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sues STOl S1111,S1E6S 



&IIHB LI 14 ^SIISI 

STl SISGS (1) ^SllGS (2) ,Q f 14| 



Htiaber 

If r^tt desifnatii an operanfl to be specified as a niiBber (assnaed to 
be a deciaal integer unless fou tell the user otherwise) several possi- 
bilities Bust be considered. 

If jou liMit th€i user to an integer less than 4096, which is not a 
preferred nethod, fou naj write: 

LI %, SIIT 

If fou allow th€i user to exceed 4095, which is the preferred nethod 
regardless of application you sust first test the magnitude of the 
operand and, in the cases in which it does exceed this value, write: 

L 1,=F»SI1fT« 

The F-tfpe literal is chosen, rather than the I-type, for invariant 
data, to avoid organizing the literaX in the user's first declared 
FSICT. 

lou nay also choose the number form for an operand that is not a pa- 
rameter but which serves to indicate the proper path through the macro 
definition, or the number of iterations of code or data generation to be 
done by the macro, this type of operand should be treated in condition- 
al assembly instructions. 

Ibsolute gjEpression 

If the value of an operand in the form of an absolute expression is 
less than W96, you may use the LI instrucrtion. If this value is great- 
er than 4095, the parameter can be made a literal, which is preferred 
fas a full word) regardless of the range allowed. For example: 

L 1,=F»5Ilf» 

The absolute expression form of operand may also be used Itn excep- 
tional cases) as a path indicator to be used by conditional assembly 
instructions . 

Code 

I code value should be enclosed in apostrophes. Some macro instruc- 
tions offer a code or some other form of operand as alternate choices 
for designating an operand. In these cases, it would not be possible to 
distinguish between the alternates without some kind of test. The 
simplest way to handle this possibility is to reguire the use of deli- 
miting apostrophes and write your macro definition to test the operand 
for a leading apostrophe. 

If the code value is to be passed in a register as a parameter, 
restrict it to four characters; if two parameter registers can be u^d, 
restrict it to eight. This is a preferred method only for short options 
related to a single data value or control block address. 
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You Baj choose a code to indicate tlie path to be taken through the 
■aero expansion or to be passed as a parameter in sone fora other than a 
character string. In the latter case, yom unst provide a translation 
algoritha through the nse of c:onditional asseablj instructions • 

Character String 

Ion should avoid this operand form in an l-tjpe macro instruction, 
but night choose to pass a character string parameter in one or a pair 
of registers. If jon choose to do so, be sure to limit the size of the 
string to conform with the amonnt of available register space. 

fon may nse a character self-defining term as the displacement field 
of an LI ins traction if the string consists of one character. If the 
string is longer than one character, yonr macro definition must employ 
an I. or LM instruction to load a literal. 

Symbol 

7ou may specify this operand form if you want to force the writer of 
the macxo instruction to specify a character string that conforms to as- 
sembler language conventions. 

Tou may also permit the writer to provide a symbolic name for the 
first executable instruction in the expansion. If so, be sure to pro* 
vide for the inclusion of the name in each model statement that may gen- 
erate the first executable instruction. 

Linkage 

Many routines called by macro instructions are privileged. If the 
module issuing the macro instruction is privileged, the macro instruc- 
tion must generate a type-1 linkage to another privileged module; if the 
issuing module is nonprivileged, a type-2 linkage must be generated. If 
a macro instruction may be issued by either type of module, your macro 
definition must test for the t3rpe of linkage you desire to assemble. It 
can do this by checking the global symbol &CHDCLS that is initialized by 
the BCLISS macro instrucrtion. 

The BCL&SS macro instruction is used to tell the assembler which type 
of linkage you want assembled for macro instructions. If the DCLASS 
macro instruction specifies US 11 class or is omitted, SCHDCLS is given a 
value of 0; if PBIflLEGSD is specified, SCHDCLS is given a value of 1. 

Some macro instructions generate only type-1 linkages regardless of 
the issuing module's privilege class. If you write one of these fence- 
sitters, be sure its entry point name begins with STS. These characTters 
are used to generate a type-1 linkage. 

finally, some macnro definitions generate code without reference to 
parameters. That is, the same code is generated every time the macro 
appears in a source program. 

BI AMPLE : Here is an example of a typical 1-type macro instruction and 
its associated macro definition, illustrating some of the points just 
made. lour macro description would be: 



p 1 1 

I Hame | Op er ation | Operand 



I [ symbol ]| BTfPS t location , length 

I 1 I 



82 



where location can be specified as an EX address and length mast be 
specified as an absolute expression; your macro definition might look 
like this: 



(1) 




HJLCBO 


(2) 


&V&H1 


SfYPE 


(3) 




JkIP 


m 


♦ 




(5) 


SHIHE 


LA 


m 




1.G0 


m 


.0P2 


III 



SLOC^SLBW 



(8) 



LC1& 



lySLOC 

.0P2 

(T'Slll EQ •0«) .12 

&1 



HlIDlfi STITllllT 

PIOTOIYPI STlTlMElf 

IF 1ST OFllIlD IS 
HISSI16 

61111IT1 II llROl 
STltllllT 

FUST GlirillTlD 
STITBllIT 



IF 2I]> OPIIIIB IS 
ilSSIHS 

IlITIILIZB SlTl 
SriBOl 

SIT ¥iI.Ul OF SETl 
SIIBOL 



TllilllTE PIOCISSIIG 

1ST OPIB&HD 1ISSI16 

21ID OFIRIID msSIlG 

TBIIlEl STITIHIIT 

In this example, line 3 tests for the presence of a first operand 
and, if it is missing, branches to an HOP statement in line 13. In 
practice jon vonld want to place some error processing code at this 
point. Error processing and the CHBIEIAC macro instruction are dis- 
cussed later. 

Line 5 is the model statement which generates the first executable 
instruction for BX address notation and would also generate the name as- 
signed to the macro instruction. 

The second operand is processed in the preferred waj . 

Finally, line 11 generates the linkage by means of the CHBIllBl inner 
macro instruction. The third operand, (C%CT1%} , represents the type-1 
linkage entry point and the fourth operand represents the BHTEl code for 
type-2 linkage. ClBimBI determines which type linkage to use. 



m M 


SBTI 


SLBl 


CIO) 


L 


0,=F«SI« 


(11) .LIll 


ciDimi 


,,(C2CX12) ,X«FF» 


C12) 


MEXIT 




(13) .11 


IIOF 




(III) .12 


HOP 




(15) 


HBIB 





S-TYPE HACBQ BEFIIITIQB 

lou should employ an S-type macro definition when you wish to gener- 
ate a parameter list in storage because the parameters cannot be con- 
tained in two registers. In S-type macro definition provides the user a 
choice of three forms of macro expansion: standard, L-form, and 1-form. 
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llie standard fora, indicated by tke omission of tlie HF-operandr 
should generate separate E- and L-foms bnt naj direcrtly generate the 
parameter list and the required linkage to tke called routine. 

The l-forn^ indicated by ET^L, generates only a parameter list; it 
does not generate any executable code. For this reason, the IX address 
operand form is not allowed in the L-form. 

The E-forn, indicated by KF=(l,listJ where "list" specifies the 
address of the parameter list as either a relocatable expression or as 
in IX address notation, generates the proper linkage and may also alter 
an existing parameter list. 

This contention permits the programmer using your macro instruction 
to conserve space in storage by generating a parameter list by means of 
the L-form and then altering the same list, in several subsequent calls, 
by means of the E-form. The I. -form is generally intended to be modified 
by each S-form that uses it. 

The placement of the parameter list may be indirectly controlled by 
the user of your mac:ro instruction, and he should be advised about these 
precautions: 

1. The S-type macrro instrucrtion conventionally places the parameter 
list in the first declared FSSCT of the assembled module. 

2. If this PSECT is declared by a macro instruction, then that in- 
struction must appear in the user's program before any macro in- 
structions that refer to the list. 

3. If rule 1 or 2 is violated, or if no FSECT exists at all, the 
standard form S-type macro instruction must place the parameter 
list in line with the code it generates and insert a branch around 
the list. 

4. L-form macro instructions always generate the parameter list in 
line. Therefore, if the user is writing reenterable code, he will 
want the parameter list generated in the area occupied by his work- 
ing storage, presumably his FSECT. This is usually done for him by 
the standard form S-type. The L-form should only be used in the 
FSECT. 

STlIMBD-FOll S-TXFB IICIO DEFIMITIOl 

Jls in the case of 1-type macro definitions, the operand forms you 
allow the user dictate certain steps in your macro definition. Here are 
standards to observe. 

Eelocatable Expression 

This operand form may be used as the argument of an I-type address 
constant either in a DC statement or in a literal. 

lumber and Absolute Expression 

If the operand specified by one of these operand forms is an actual 
numeric value, it is only necessary to generate an F- or 1-type address 
constant, keeping in mind any size constraints that might necessitate 
the use of length modifiers. Full-word F or A constant is preferred. 

Code 

If a code is to be passed as a parameter or is to be translated to a 
value to be passed as a parameter, you must pass it in the parameter 
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list and not^ as ±t. the case of the 1-tfpe Macro instruction ^ in a 
register. Since the code ^ay onlf be one ter»^ fon aaj use anf tfpe of 
constant to generate the parameter in the list. If the code is a 
character string tLat includes apostrophes, yon must pass it as a 
character constant and adhere to the rules for writing snch constants, 
lotice also that the f SS assembler reduces all double apostrophes and 
double ampersands to single apostrophes and ampersands. 

Again, yon may choose to use the code as a path indicator. If yon 
wish to pass a variable-length parameter list, you might use a code to 

indicate the length of the list being passed. 

Character String aad Text 

These types of operand forms may be used in two ways. Ton can pass 
the operands to the called routines as character strings in the parame- 
ter list; you can generate the character strings and then enter a point- 
er to them in the parameter list. The latter method is preferred, with 
the variable length of the string or text generated as a full word imme- 
diately preceding the string (no separate field or pointer for length) . 
Since the parameter list produced by the S-type macro instruction nor- 
mally is a list of pointers, you will, with few exceptions, use this form 
of operand in charairter constants or character literals. 

fou are responsible for verifying the presence of a leading apc^- 
trophe in a text operand and for providing error processing if it is 
missing. The assembler program checks for the terminal apostrophe. 

Two methods for checking the length of a character string are availa- 
ble. Is you can see in Figure 17, you may test for either the 1 or the 
L attributes. The reason for subtracting 2 from the count of STIXT be- 
fore placing it in the SITI cell is that the assembler includes the 
delimiting apostrophes in the count. If you want to find the length of 
the character string, bear in mind that delimiting apostrophes will have 
been stripped and double apostrophes and ampersands will have been re- 
duced. Thus, had the programmer written the operand STKXT as: 

•ISl THIS SYMBOL SS» 

you would find its K attribute to be 20 (including terminal apos- 
trophes) . Statement 3 of the example would yield the value 18 in the 
SETI cell. Statement 5 would yield a value of 17 in the SETI cell since 
statement 4 would have generated STBXT stripped of its terminal apos- 
trophes and one of the two ampersands. 
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(1) 

(2} 



IICIO 
HICI 



STBlf 



(3) SIl SETI 



K«STlIT-2 



(«IJ CHDXX BC 



C'STEXT* 



(5) 



Sll 



SlTl 



L'CHDIX 



HEVB 



figure 17 • Determining the length of a character string 

Syabol 

Ion maj use this operand forn in several ways: in the name field of 
a generated statement, as a character string to be passed as a parame- 
ter, or as an entrj point or modnle name to be nsed as the argument of 
an address constant, osnallf 1-type or ¥-tfpe. 

L-fOBi S-TIPB lIClO DIFIIITIOI 

IX addressing is not allowed in the I. -form of the S-tfpe macro in- 
strnction* The L-form is nsed to generate a parameter list only^ Since 
BX addressing requires the generation of executable code, it cannot be 
used. 

BXAMPLE A: Coding the L-form part of an S-type macro definition 



CI) IICBO 

(2) SMIHE SflPB SLBIiI.OC,&FBCK:,SSYl,SSYHLEli, 

SEF=I 



HEIDBB ST&TBHBHIf 
FSOTOTTPB 



IIF 



(•S1F» EQ •!•) .LFOBl 



LFOBl OF lACBO? 



(3) 


.LFOBH 


IIF 


m 




IIF 


(5) 


SIAIIB 


DC 


(6) 


.Sll 


ilF 


(7) 




BC 


(8) 




IIF 


m 




DC 


flO) 




LCLB 


(11) 


.PBGC 


IIF 


(12) 




IIF 


(13) 


SB 


SETS 


(14) 


.01IT3 


DC 


(15) 




MBXIf 


(16) 


.OMITl 


AH OP 



••) .El 

0) .OlITl 



■ • 



)-E2 



(•SHIIB* EQ 
(K»&LBHLOC BO 
1 C&LEILOC) 
(■&Sfl» EQ 
CL8«SS¥1» 

(K'SSyMLBH EQ 0) .E% 
1L1(&SYHLEI) 
SB 

(K*&PBOC EQ 0) .0IIT3 
(•SPBOC» HE ■£• IHD 
■SP10C» HE "P*) .E3 
(•SPBOC» EQ »F») 
111 (SB) 



IS H&IE FIELD OK 

IS FIBST FIELD OK 

EHTBB FIBST OPBBAHD 

3BD OPEBAHD OK 

EHTBB 3BD OPEBAHD 

4TH OPEBAHD OK 

EHTBB <»TH OPBBAHD 

ESTABLISH SBTB 

IS 2HD OPBBAHD PBBSEHT 

IS 2HD OPBBAHD VALID 

SET CODE 

DEFAULT 2HD OPEBAHD 

DEFAULT 1ST OPBBAHD 
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C17) &Hiai BC 1(0) llSUHl PR0C1SSI16 

(18) AGO .SIH 

(19) .El JkHOP 

(20) .E2 HOP 

(21) .£3 HOP 

(22) •£<! HOP 



(23) lElD 

Exaaple i illustrates this limitation. If you intend to persit the 
user of your aacro instruction to use the L-forn, you aay wish to eapha- 
size the operand fora liaitation in your sacro description. All other 
operand forms allowed in the standard form are also allowed in the L* 
forn. Although operands in L-forn way be used as path indicators^ they 
are generally used ms the arguments of BC statements or are translated 
to values that are used as arguments. 

Since the user controls the placement of the parameter list, do not 
include a statement to generate a €x>ntrol section; specifically, don't 
attempt to locate the parameter list in the PSECT. 

Figure 18 shows how the S-type mai^:t> definition in Example A would be 
presented to the user, lotice that the name field in the L-form is man- 
datory. This is a good general rule to follow because most users gener- 
ate the parameter list and later modify it with an E-form. The name as- 
signed the L-form is a good way to identify the parameter list for later 
modification . 

The coding shown in Example A would generate the parameter list shown 
in Figure 19 « Statements 3, H, 6, 8, 11, and 12 test for the existence 
and the validity of each parameter. Statements 5, 7, 9, 1%, and 17 gen- 
erate the parameter list, lotice that lines 3 and 6 use a null test to 
verify the presence of operands. 

Standard form: 

• 1 ^T ^ 1 

(lame {Operation {Operand I 

I 1 4 ^ ^ , 

I [symbol]) ST IPS {length location, procedure, symbol, symbol length | 

I I J . I 

L-form: 

J J .^ . ^ 

fVame {Operation {Operand | 

I 1 ^-1 ^ ^ f 

{symbol (STIPE ([length location], [procedure], symbol, symbol length, { 

I I |HE=I. ( 

I 1 ^j ^ .§ 

Figure 18. Standard and L-form S-type macro description 

Defaults have been provided in lines 1% and 16. If the secx>nd 
operand is omitted, line 11 branches to line 14 which uses SB as the 
argument of the address constant. Since SB was initialized to zero by 
the LCLB instruirtion, line 14 assumes zero (indicating P) . 

In your definition, lines 19 through 22 would be followed by error 
processing. 
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r " ' " ' ' ' 1 

symbol ♦ | lengthi | 

— ^ 1 

-*- 4 I [symbol] | 

. 1 1 

*12 



♦ 13 

Figure 19. Paraaeter list generated by L-fora 

B-FOIM S-TIPE HICIO DIFIIITIOIS 

fbe B-for» macro instruction may modify a parameter list and may gen- 
erate the linkage to the cralled rontine. Since this requires tbe 
generation o£ estecutable instrucrtions, some changes must be made in the 
operand forms. 

HI Iddress (formerly known as ••explicit'^ or ••implied* address) 

This form of operand must be substituted wherever relocatable expres- 
sion is allowed in the standard form. The use of these forms will 
difffer from their use in the standard form in that you use them to com- 
pute the effective address and then store that address in the parameter 
list, lou should tell the user that he must provide a base register. 

By convention, general registers 14 and 15 are used as working regis- 
ters in the macro definition , because the linkage you generate destroys 
their original contents anyway. 

number and Ibsolute Expression 

Operands specified in these forms are treated much the same as in the 
K-type. A Load (preferred) or load Address instruction is used to load 
register 14 with the operand value. The choice of instructions again 
depends on the magnitude of the operand value. 

Because II address notation must be allowed in the iF= operand, you 
must include a test for it and provide for loading register 1 with the 
address specified. 

Code and Symbol 

Operands expressed in these forms may be used as path indicators, and 
the symbol form may be used to name generated instructions. Although 
these operands are permitted in the B-form, you will seldom find them 
useful. 

Linkage 

ihen your macro definition is generating the linkage to the called 
routine, you should generate the entry point in a V-type address con- 
stant literal, lot only is this a convenient method, but the assembler 
program will place this constant in the proper control section ~ a 
PSECT, if one exists. 

ihen generating a type-1 linkage, your E-form macxo definition must 
generate both V-constant and 1-constant literals. You can use the inner 

macro instruction CHDINIBA, which is discussed later, for this purpose. 
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BIIMPLB B : Coding -the l-for» part of an S-tfpe aacro definition 



(1) IICIO 

(2) SIIIE STIPE 



SLElI.0CrSP10C,&lP=I 



HEIDEl SflTElElf 
PlOTOtlPE 



IIP 



(•S1F(1)« EQ »E») •BFOll 



EPORl OF IICEO? 



(3) 
(«) 
(5) 


.EFOBH 
&H&HE 


HOP 

DS 

CHDIIIBI 


OH 
SIF (2) 


(6) 




I IF 


CK'SLEILOC EQ 0) .Pl< 


(7) 
(8) 
(9) 


.P80C 


LI 
ST 
IIF 


1«I,SLEIL0C 

« ^0(0,1) 

(K*SP10C EQ 0) •LIIl 


(10) 


# 


IIF 


(•SPIOC* IE ■F» HD 


(11) 
(12) 
(13) 
(14) 


SB 


LCLB 
SETS 
LI 
STC 


SB 

C»SP10C» EQ »F») 

14, SB 

14,13(0,1) 


(15) 
(16) 
(17) 
(18) 


.LIMK 
.B1 


CHDIMIH& 

lEXIT 

HOP 

lEXIT 


,, (C2CXIZ) ,X»FF» 



ElTlf POUT 

ALIGIHBIT 

LIST IBDIESS II 

lEGISTEl 1 

IS THEIE 1 1ST 

OPERHB 

1ST OPEIHB TO LIST 
IS THEBE I 21B 
OPEBHB 
8 "P*) .B1 
IS IT ¥1LID 
BSTIBLISI SETB CELL 
SET SETB CELL 

STORE COBB II PIRI 

LIST 

GEHERITE LI1KI6E 



Figure 20 demonstrates the E-for« of the macro instrnction described 
in Fignre 18 and the parameter list shown in Figure 19, The coding for 
a tfpical E-form S-type macro definition is shovn in Example B. 



E--form: 

I 1 ^ ^ — I ^ 

I Rame | Operation | Operand 

I 1 .-+. 

I [symbol II STIPE 

I 1 



I[ length location ][ , procedure ],HF= (E,list) 



Fignre 20. B-form S-type macro description 



Mote, in Example B, that the only error test is for an invalid second 
operand* 111 parameters may be omitted if no change is desired in that 
field of the parameter list. 



lODIFIEB R-TYPE MICRO BEFIIITIOIS 

Ion may choose (in exceptional cases) to pass parameters in registers 
other than and 1; this makes the definition a modified R--type. If 
your macro instruction links to the called routine by means of an SVC, 

you may pass parameters in registers 14 and 15. 

lo change in operand forms occurs between R-type and modified R-type 
macro instructions. 
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lOBIFIlB S-TIWE IICIO DEFIIITIOIS 

In s-tjpe aacro instructioE Kaj kdtWB no standard fora aa€ an B-fora 
that ioes not generate anf linkage • fhese are aoclified S-type aacro in- 
structions ani thef seore onlf to generate and to alter a paraaeter 
list, 

Inother tfpe of aodified S--tfpe aacro instrncrtion is the type that 
has only a standard fora; it does not ha¥e an L-fora or an B-fora. 



TECHMIQPIS gSBD II WRITIWG BACRO BSFIWITIQMS 

llGISTEl iOflTIOl 

Special register notation should be specified when yon vish to allow 
the user to load paraaeters (not addresses) into registers before execu.-^ 
tion of the aacro instruction* By con¥ention, these registers are re- 
stricted to and 1 for standard 1-type macro instructions. Registers 
14 and 15 aay also be used if the l~type aacro instruction is of the 
modified type. The regnired Method of linkage aay place additional 
restrictions on the use of registers 14 and 15. 

Register notation and registers for IX-Iddress use are liaited to 
registers 2 through 12 in order to avoid the loss of paraaeters. Assuae 
that yon want to pass paraaeter PI in register and paraaeter F2 in 
register 1. iithont this restriction on register nsage^ the user aight 

issue the HAfOC aacro instrnction like tEis: 



1 
HAfOC 



0,P2 
1,P1 
(0) . (1) 



lour aacro expansion would then do this: 

LI 0,1 THIS IS PARAIETBR Fl 

LI 1|.0 TEIS IS lOT FARAHBTBR P2 

If yon Bttst use registers other than the conventional ones for work- 
ing registers r and do not save and restore thea,. be sure to warn the 
user- 

PACKIIG PAIIIETBIS 

If you wish to pass two related short paraaeters or several flags in 
one register ,r you aust pack the paraaeters. Figure 21 shows the aethods 
for pacing two parameters^ eack a half word loiig^ into register 1. 



SOPA is register 
notation 



SOPA is an 

absolute expression 



SOPB is ! 






"" i ^ 


LCLA 


"~" •"'■ • ■ 1 

&A 1 


register 


1 LR 


I^SOPAfl) 


ISA 


SITA 


SOPA*65536 I 


notation ! 


SLL 


1i.16 




L 


1,=F«SA» I 




1 OR 


1^S0PB{1) 




OR 


1,&0PB{1) 1 


SOPB is ! 


LI 


1^S0PA(1| 




LCLA 


&k 1 


an absolute 1 


SLL 


1,16 


l&A 


SETA 


S0PA*65536 | 


expression i 


LCLA 


&A 




L 


1,=F»SA« r 




SI SITI 


&OPB 


t&A 


SETA 


SOPB 1 




1 


1,=P»SA» 


- : i 





1,=F»SA» 1 

- - _ .- - . J 



figure 21. Packing two half word paraaeters into register 1 



m 



Sisllar teclmiqQes can be used for other cases* Here are two 
ezanples : 



EX AMPLE I; 



Parameter PI - three bytes left aligiiei 
Parameter P2 - one bfte right alig net 
Both parameters given in register notation 





Procedure 




LCIsk 


&A 


&I 


SETk 


SP1*256 




L 


1,=F*&I« 


Bk 


SETl 


SP2 







1^=F»SI* 


EIIIPLE B: 







Parameter PI - one byte left aligned 

Parameter P2 - three bytes right aligned 

Both parameters given as absolute expressions. 

Procednre 

SI 

&1 



LCL& 


&& 


SETi 


&P1 


L 


0,=F"&i» 


SBT& 


&P2*256 


L 


1,=F«6A» 


SBDL 


0,8 



nEFIlIlG IIIBI IICIO IISTIUCTIOIS 

The inner macro instruction CHBIIIBI has been nsed in previous 
examples. Ion will find this type of instruction not only convenient 
bttt also economical in terms of lines of code written^ lines of code 
generated, and time expended in asseibly* 

ton needn't write as mnch code in your outer macro definition, since 
the inner macro instruction will supply it for yon. Ion may also reduce 
the number of generated statements by using conditional calls. Ion 
might, for example, write: 

IIF cmF* LE 5) .10111 
lllEllIC 



.10111 HOP 



The inner macro instruction would only be called if SOP were greater 
than 5. Is you can see, the use of the inner macro instruirtion is some- 
what analogous to the use of a subroutine. 

Basically, the reasons for using inner macro instructions are the 
same as those for using subroutines » If time and space will be saved, 
define and use an inner macro instruction. 

Bon*t nest more than three levels of macro definition. This techni- 
gue will keep the definition clean and intelligible. 
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Don*! define an inner aacro instruction for nse with only one outer 
macro instruction; use a conditional assembly subroutine instead. As- 
sume that you want to conditionally enter a subroutine from points k, B, 
and C. you must provide a means by which the subroutine can return to 
the correct point after each of the three calls. You can do this by 
establishing a SBTC cell and altering its contents prior to each condi- 
tional branch. Example C illustrates this technique* 

EIAMFLE C : Branching to and returning from a conditional subroutine 

IICBO 



LCLC BMTlSiW 



&lf II SETC • . If IH 1 » 

IIF (SOFI GT 10) .SI 

.RTR11 HOP 



SHTIM SETC •.HTBli2» 

IIF (![»S0P2 EQ 0) .SI 
.1T1I2 HOP 



Sirai SEfC ■.BTH13* 

IIP (L«S0P2 LT 1) .SI 

.ETfiI3 HOP 



lEXIf 
.SB HOP 



160 SBfBl (EID OF SUBBOOtlVE) 



HEHB 



MHIIIG THE FIfiST EXBCBTIBLE IHSTR0CTIO1 

It is possible to put the name field of the macro prototype statement 
on the first executable instruction even when there is more than one 
model statement that may be generated as the first executable instruc- 
tion. It is preferred, however, to use the name in the name field of a 
non-executable assembler statement (for example, SVIHB DS OH or &VAIIS 
EQO *) . 

SETTDIG TEE SIGH BIT 

If you define a macro instrucrtion in which the user way specify the 
sign of operand two by the presence (negative) or the absence (positive) 
of operand one, you may find it difficult to properly set the sign bit. 
Examples D and B illustrate two techniques you might find helpful. 
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Ifter establlsliiiig Slfl ant SlfB cells ^ line 5 places the proper bit 
value in tbe SlfB cell, basei on tbe presence or tbe absence of 0P1» 
liine 6 tben generates tbe paraneter in storage nsing tbe value in the 
SETB cell for the sign* loti<^ that the length modifiers in line 6 spe* 
cif J the length in bits. Ton anst use one line for the DC stateaent. 
If fon use tvo lines, the second line will be aligned on a bjte bonndarf 
and the sign bit will be lost* 

Bxaaple E illustrates another technigme; it uses the sane HICRO, PIO* 
fOflFl, and LCU statements from Ezaaple B* In Ezaaple E, line 7 tests 
for the absence of 0P1» If it is absent, the sign is to be positive and 
lines 15 and 16 generate a positive value in register 1. 

If the sign is to be negative and 0P2 is zero, line 12 generates a 
negative zero in register 1. 

If 0P2 is to be a negative nnaber other than zero, line 9 computes 
the tvo^s complement of 0P2 and places it in the SETI cell* line 10 
loads register 1 vith the negative SE71 sjmbol* Thm assembler vill con- 
vert the value in SI to its negative tvo*s complement. Since the value 
in &1 is alreadf the two's complement of OP2, line 10 will load the 
absolute value of 0P2 with the sign bit on. 



BXAHPLE D: 






(1) 


HACBO 




(2) &H&HB 


B&CEX 


&0P1,&0P2 


(3) 


LCL& 


Sk 


W 


LCLB 


&B 


(5) &B 


SETB 


(K»S0P1 BE 0) 



m 



DC 



11. 1 (SB) ,11.31 f&OP2) 



BIABPIE E: 






(7) 




AIF 


(K»&0P1 BQ 0) .OHIT 


(8) 




kit 


(&0P2 EQ 0) .ZEBO 


(9) 


6k 


SBTl 


X»7FPPFPFP«-(60P2-1) 


(10) 




L 


1,»F»-&A« 


(11) 




AGO 


.DOBE 


(12) 


.ZEBO 


L 


1,=X«80000000» 


(13) 




AGO 


.DOBB 


(IH) 


.OHIT 


ABOP 




(15) 


SI 


SETA 


50P2 


(16) 




L 


1,=P«SA» 


(17) 


.DONE 


ABOP 





P10CESSI1G I SIIGLB IPOSTIOPHE 

lou must exercise caution in the treatment of operands that maj 
validlj contain single apostrophes. If, for example, a single apos- 
trophe is found in a character relation in an IIF instruction, it will 
produce invalid sjntaz. 

There is a waj to test for single apostrophes without violating syn- 
tax rules, lou might write 
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Ikis ttsa of substring notation concatenates the operand field yon want 
to test with itself y thereby generating a pair of the tested character » 
Thus, if the character tested is an apostrophe, paired apostrophes will 
be produced and no violation of the rnles of syntax will result. 

It«s worth noting here that there are three methods available to yon 

to test for the presence of an operand 

1. IIF iK^BOl^EnkWn IQ 0) .OUT 

2. IIF (T»S0P1BI1D m 'O") .OHI^ 

3. IIF f»SOPBlIlD» EQ » ») .OMIT 

Method 1 tests for a count of zero, method 2 tests for a type of 
••omitted*^, and method 3 tests for a null character string. lou should 
not use method 3 if it is possible for a single apostrophe to appear in 
the operand. I test for the K attribute is your best course. 



RBF1R1I16 TO THE BOB 

If the macro instruction you define must refer to the user»s DCB, you 
should express references to the various fields in terms of symbolic 
notation. Reference to fields in terms of byte displacement is bad 
practice; if the DCB is ever redefined, your byte displacements may no 
longer be correct. The use of symbolic field names requires the user to 
have previously issued a BCBD macro instruction or the macro instruction 
currently being defined must issue a DCBB inner macro instruction. 
Since the DCBD macro instruction uses the global symbol 5CHDDCBD to pre- 
vent multiple expansions of the BCBD macro instruction in one assembly, 
there is no reason why BCBD should not be coded as an inner macro in- 
struction to allow symbolic references to the user's DCB. If you want 
to avoid the error message normally issued for duplicate DCBDs, you can 
test SCHDDCBD within the macro instruirtion code before issuing DCBD and 
branch around it if the value is not egual to 0. (lote, however, that 
if the user has copied CHIDCB and issues DCBB, duplicate symbols will 
result .) 



SIZE LIMITITIOM 

If the operand is not a sublist, it must not contain more than 255 
characters. If the operand is a sublist and the only references are to 
individual members of the sublist, each member may be up to 255 charac- 
ters long. ¥ou are not restricted in the number of operands or in the 

number of sublist elements. 

IDDRESS COISTIITS 

If an E-type address constant refers to a symbol defined in a program 
that has no PSICT, then the R-value defined is the origin of the control 
section containing the EITRY statement whose operand field contains the 
argument of the R-type constant. Thus, given R (X) , where X is defined 
in an assembly module having no PSECT, the R-value is the origin of the 
control section containing the statement: 

ElTRl X 

If there is a FSECT, all address constant literals are located in it. 
If no PSECT exists, the constants are placed in a literal pool. 

V-type and R-type constants must have only a single relocatable sym- 
bol as an argument. If an operand is to become the argument of such an 
address constant, you should show the operand form as ••symbol." 

m 



I sjmbol X and a ¥-tfpe cx>iistaiit witk an argEsent of X Maj both be 
defined in one asseablf module. Unless X is also defined as an entry 
point to the nodule, tbe ?~tfpe constant is resolired by searching for a 
definition of X outside the current module* 

Testing the tf pe attribute of a sfabol for the value T will onlf in- 
dicate whether it is defined as the operand of an EXfRl stateaent in the 
assembly. If a symbol is externally defined as the argument of a ¥-type 
or l--type address constant, its attribute will be given as U for unde- 
fined. This cannot be considered as a conclusive test, however, since W 
is also the attribute assigned to symbols internally defined by an IQO 
statement. The test for a type attribute of T can only be nsed to indi- 
cate that a symbol was defined by means of an EXTII statement. 

If your macro instruction generates an implicit adcon group and may 
be called from a user-written program, it is not safe to assuae that the 
user has defined cmtry points with either EXTll or EITIY statements* 
The type of constants you generate should be determined by testing for 
the T-value of the type attribute. If it is present, you may generate a 
f-type and S-type constant pair. If it is not present, generate an A- 
type constant pair. Idmittedly, the user may have defined the symbols 
with lETll statemcints but, since there is no way to test for them, this 
is your only safe course. 

Conventionally,, the 1-value of the I~type constant is assigned from 
SSXSPSCT C^hat is,, the first PSICT) . If this variable is null, indicat- 
ing that no PSICT exists, the B-value is assigned (from &S1SECT) the 
origin of the CSECT from which the macro instruction has been issued. 

In exception to this convention occurs in the IBCOl macro instruc- 
tion. Since the user controls the placement of the iDCOl macro instruct- 
tion and probably wishes the adcon group constructed in the same FSICT, 
the 1-value is always assigned the value from &S1SBCT. lou should use 
this same technigue when you want to let the user declare more than one 
PSECT and generate the adcon group in a PSECT other than the first. 

TEIMIIAL IPOSTROPIIl 1»D SIZE LIIITITIOl 

Assume that a user writes a text operand that is 258 characters long^ 
including terminal apostrophes. After you have tested for the initial 
apostrophe, you scjek to determine the K attribute. Since this attribute 
is expressed in modulo 256, you would receive a character count of 2: 
the initial apostrophe and the first character. The terminal apostrophe 
would be missing and an error message would be generated by the assem- 
bler program. 

KEIWOID OPEIAIDS AID STAIBIID ?ALOES 

If you write a macro definition and include a keyword operand to 
which you assign a standard value, the type attribute of the standard 
value is assigned to the operand if it is completely omitted by the 
user. If he writes KEI101D= and follows the egual sign with a blank or 
a comma, the type attribute of the operand is O for omitted, and the 
standard value is overridden by the explicitly specified null string. 

SUBSTBIIIG HOTATIOif PROCESSIIG 

If you use substring notation to refer to a subset of characters in a 
character string, you must first ensure that the characters are present. 
Assume, for example, that you want to test the first four characters of 
an operand to see if they specify some specific action to be taken, lorn. 
should write something like this: 

AIF (K»SOF IT i|).E1101 

AIF (•&0P»{1,4) EQ •1EG1»).P10C 
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If fou don't do ±h±B mud tke user codes a character string of less 
than four characters^ the asseabler will produce error messages. 

lEhis technique anst be eaployed where register notation is allowed. 
Since yon will use substring notation to test for the opening parenthe- 
sis^ fon BQst first determine that the operand has been coded. The nser 
waj have cdiosen to onit the operand. 

lotice also that fou can gain access to a character subset in an ele- 
ment of a smblist bf writing something like this: 

•S0PEH11D(2) • Clfl) 

This refers to the first character of the second element in the snb- 
list SOPIHAID. 



1 ATfBIBnfE DSI6B 

The I attribute counts the number of operands or the number of ele- 
ments in a sublist bj counting the number of commas and adding one. Is 
a result, the I attribute cannot be used to count the number of non-null 
operands or non-null elements in a sublist. 



I"&SfSLIST 111DI.I1IG II IIIEB lODl HICEO USTlUCTIOl 

Keyword operands are not included in the value of the I attribute of 
SSISIIST in mixed mode operands. If there are no positional operands, 
1»&S1SLIST is zero. 



SUBSCIIPTS IID SUBLISTS 

If a subscripted reference is made to an operand that is not a sub- 
list, the whole operand is used. Thus, if jou write DC 1(&0P(15)) and 
the operand is not a sublist, jou generate the operand as the argument 
of the I-type constant, just as if you had written DC I (SOP) . 

SITC SIIBOL LllGTH 

The maximum length of a SITC symbol is eight characters. Is a re- 
sult, you may not be able to use in its entirety the operand of a SBTC 
statement written as a relocatable expression, absolute expression, or 
character string. Instead, it is better practice to use the operand in 
groups of eight, being careful to test for the presence of characters 
before attempting to use them. 



For 


example: 






C2) 
(3) 

m 


Sliai 


HICEO 
IHSTl 
LCLt 
LCLC 


SPI 

&CT1,SCT2,&CT3 

&S(6) 


C5) 

m 
ay 
m 


SCTl 
&CT2 
SCT3 
.LOOP 


SETk 
SITI 
SBTl 
IIP 


CK"SPlf2)-2) 

1 

2 

(SCTl LE 8) .OUT 


m 


SS (SCT2) 


SETC 


»SP1»(SCT3,8| 
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(11) 

(12) 


SCfl 
SCT2 
SCT3 


SITI 
SETI 
SlTl 


&Cf1-8 
SCT2-H 
&CT3+8 


(13) 




AGO 


.LOOP 


(15) 


.OOf 
SS(&C!r2) 


HOP 
BWtC 


•SP1»( 



(16) 



SHIHl 



SP1 C 1) BS (1) SS (2) SS (3) SS (i) &S (5) SS (6) 



(17) 



HllD 



Ike IHSTB macro is given one parameter ttiat Is a two (2) element siili-* 
list. The first element Is an Instruction and the second element Is the 
operand field for that Instruction expressed as a character string. The 
local SEIC sjmbol, SS (6) , Is a six (6) element arraj Into vhlch we can 
put the operand field from &P1. Bf concatenating this SITC arraj In 
line 16, we can generate the requested Instruction. In this example, 
SP1 (2) Is limited fjo 48 characters. 

iOGICil fBBHS II lELITIOllL BXPIBSSIOIS 

then a relational expression Is used In the operand of an IIF or SITB 
statement, the terms on either side of the relational operator must both 
be arithmetic expressions or character expressions; neither of the terms 
can be logical expressions. This Is Illustrated In the examples below, 
onlf some of which are valid. &B(1), SB (2) , and SB (3) are SITB 
variables. 



valid 


KZT 


inTalid 


AIF 


inTalid 


ilF 


valid 


kzr 


valid 


AIF 


valid 


AIF 



( (SB (1) ♦SB (2) -►SB (3)) WB 0) .01 

((SB(1) OE SB (2) 01 SB (3)) IQ 0) 

(SB (1) BQ 0) .Ol 

((SB(I)-H)) B(J 0) .01 

(SB(1)) .Ol 

(SB(1) 01 SB (2) 01 SB (3)). 01 



»01 



COlfElTIlO DECIIII. TO HBXIBBCIIIL 

Sometimes It maj be useful to conveirt an Input decimal number to Its 
hexade<:lmal egulvalent. The following example Is one waj this maj be 
done: 





IJiClO 




SIAHB 


COIV 


SDEC 




LCLC 


SSTl 




LCLh 


SD,SQ,S1 


SB 


SETA 


SBEC 




IIF 


(SBIB 0) .STIT 


SSTl 


SETC 


to* 




AGO 


.OUT 


.STIT 


IIF 


(SB I.T 16) .BIB 


.LOOP 


IIF 


(SB IT 16) .BOIB 


SQ 


SETI 


SB/16 


SI 


SBTI 


SD-16*SQ 


SSTl 


SETC 


•FEBCBI9876543210* (16~S1,1) .■SSTl* 


SB 


SETI 


m 




IGO 


.loop 


• BOIB 


HOP 




SSTl 


SETC 


•FEBCBI98765II3210* (16-SB,1) .•SST1« 




AGO 


•OOT 


• BID 


HOP 




SSTl 


SETC 


■123II56789IBCBBF* (SD,1) 
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• OUT 
SIIJIHB 



&1I0P 

DC 

HEVD 



XLi|»SSTH» 



SETTIMG OP FLAG BITS III A BYTE 

Sometines it is necessarj to generate a byte that contains bit flags 
that will be meaningful to a program that is going to be called* Here 
is an example of how to do this using local SITB symbols: 



SHAHS 



SB(1) 
SB (2) 
SB (3) 
SB(I|) 

SFLG 

SHAHS 



HACEO 
FlAG 
LCIA 
LCLB 

SSM 
SETS 
SETB 
SETB 

SETA 

DC 
HSHD 



SP1,SP2^SP3^SPI| 

SFLG 

SB (4) 

(»SP1« EQ •F1»> 

(•SP2» EQ »F2») 

(»SP3» EQ ■F3») 

(•SPi»» EQ "Fir*) 

SB(lJ*t +SB(2)*2 ♦&B(3J*ft -frSB (l») *8 

ALl(SFLG) FLAG BIfE 



The four parameters on the FLAG macro can be specified as Fir F2r F3r 
and F4 respectively. A local SETB symbol is set if any flags are speci- 
fied. Then, each SETB symbol is multiplied by t^he decimal eguivalent of 
the hexadecimal number that represents its flag bit within the flag byte 
Cthat is, the flag bit for F4 is a I»08» or decimal 8) . The results of 
the four multiplications are added and the result placed in -the DC in- 
struction that will generate a byte containing the appropriate flag 
bits. 



GAIHIBG ACCESS TO HACBO LIBBABIES 

The macro instructions defined for your use in TSS are divided among 
several libraries. The first, TSS*****.S¥SHAC, contains those macro 
definitions needed to support nonprivileged user assemblies; the exter- 
nal descrip-tion of each of these macro instructions can be found in this 
manual or in Assembler Pser Hacro Instructions . A second, TSS*****. 
ASHHAC, c:on tains other system macnro definitions, such as those for the 
on-line test system (OLTS), and the system DSECTs. This division per- 
mits each installation to move the less freguently used library, TSS**** 
*. ASHHAC, out of public storage (by means of the fT command), freeing 
the space for other purposes. If this is done, however, the macro li- 
brary must be renewed on public storage (by means of the T? command) be- 
fore it can be used. Other macxo libraries exist for special system ap- 
plications and are documented with those applications. 

While the macro instructions contained in TSS*****.STSHAC are always 
available to you without having first to define the library, this is not 
true of the macro instructions contained in the other library. To gain 
access to TSS*****. ASHHAC, you must first issue the following SHARE com- 
mand (unless your user identification is TSS, in which case the library 
is already in your catalog) : 

SHA BE DSlAHE^dsname 1 , OSEBID^^^TSS ,01HEBDS-ASHHAC 

where dsnamet is any valid data set name you choose to give to the li- 
brary. Tou must also issue a SHABE command to gain access to the li- 
brary index: 
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SHJIIB I>SIIHE»dsiiaBe2,llSllIB^TSS,0fflll1>S==&SHljDl 

where dsnaaei is a&f valid data set naae fom choose to give to the 
index* 

Ilthough both ISHIAC a&d ISBIDI are generation data sets, onlj these 
two SHlll coaaands need be issued, since thej provide access to aU 
generations. Fnrtheraore, 7011 need onlf issue these coaaands the first 
tine fou want to use the librarf 1 jonr sharer's status is peraanentlj 
recorded bj the sfstea at that tiae. However, in each session in which 
fon want to use the library, including the first, jou aust also issue 
the following DBSF coaaands, even if your user identification is fSS: 

DDIF BDIlll=ddnaae1 ,DS0BG=?I,BSl&Ml=dsnaae1 Ci:} 
BDIF BBIJlHS='ddnaae2,BS01G:=¥S,DSIIHS»dsnaBe2 (x) 

where ddnaael and ddnaae2 are anj valid data definition naaes of your 
choosing; dsnaael and dsnaae2 are the data set naaes you assigned to the 
library and index, respectively, when you entered the SHIll coaaands; 
and (X) denotes the absolute generation nuaber of the library and index 
you wish to access. (0) would indicate the latest generation; (-1) 
would indicate the next aost recent generation, lote that the data 
definition naaes entered here as ddnaael and ddnaBe2 aust be entered as 
the ddnaae of the syabolic portion of the suppleaentary aacro library 
and the ddnaae of the index portion of the suppleaentary aacro library 
in the parameter list following the JISH coaaand if you want to asseable 
aacro instructions defined in !rss*****.ISlI&C. 
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P&BT II: SYSflM MACRO IgSTRPCTIOlS 



This part describes macro instructions of special interest to tlie 
sfsteM programmer. Thej supplement tlie macro imst met ions available to 
all TSS users y described in Assembler Pser Macro Instructions » 

Some system macro instructions can be issued onlf bf a privilege 
class E user (system monitor) r a privileged system programmer (privilege 
class Bp authority code O) ^ or a non privileged system programmer (privi- 
lege class Dp autbority code PJ « Otber system macro instructions have 
no privilege requirements; tbey simply make system coding easier. 

Section 1 explains bow tbe macro instructions in this book are 
described. 

Section 2 describes tbe macro instructions j. arranged alpbabetically . 
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SBCYIOl 1; HOf HICBO IISTIPCTIQIS ABE DBSCBIBBP 



First y to anderstancl liow Macro iDstroctioas in this book are descxib- 
ed, look at Figure 22. Tbis figure aaj also ser^e as a quick reference 
vben reading a aacro instruction description. ¥ou aay wisb to tab it* 

The inforaation vbicb follows suppleaents Figure 22. I aore detailed 
explanation of operand forms defined by the assembler language is con* 
tained in Assembler language > GC28-2000. 

Haae Field 

In aost sacro instructions, the syabol in this field becomes the name 
of the first instruction generated. 

Operand Field 

The operand field aaj contain no operands (in which case this is 
noted below the format illustration) , or one or more operands separated 
bf commas. 

The user must supplf positional operands in the same order as that 
shown. If a positional operand is omitted and another positional 
operand is written to the right of the omitted operand, the comma that 
would have preceded the omitted operand must be retained. For exiuiple, 
assume positional operands A, B, and C. These maj be written: 

I A,B,C I A,,C I A,B f A I ,B r , ,C | 

I 1 • 1 1— . ^ 1 ^ I J 



OPIBAMD FOBMS 

Absolute Expression 

An absolute expression may be an absolute term or anj arithmetic com- 
bination of absolute terms; an absolute term may be a single absolute 
symbol or self -defining term. All arithmetic operations are permitted 
between absolute terms. 

In the following examples, AlAl and JAl are relocatable and defined 
in the same control section; lABK and BBIC are absolute: 

331 

HABK 

MABK-i-EBIC-2 
ALAM-JAf 
HABK*«l-BfiIC 

Belocmtable Expression 

A relocatable expression is one whose value would change by n if the 
program in which it appears is relocated n bytes away from its original- 
ly assigned area of storage. All relocatable expressions must have a 
positive value. A irelocatable expression may be a single relocatable 
term. A relocatablfi expression may crontain relocatable terms — alone 
or in combination with absolute terms — under the following cxinditions: 
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1. There must be an odd naaber of relocatable terms. 

2. kll relocatable terms but one mast be paired. 

3. The unpaired term must not be directly preceded by a minus sign. 

^. k relocatable term must not enter into a multiply or divide 
operation. 

A relocatable expression reduces to a single relocatable value. This 
value is the value of the odd relocatable term, adjusted by the values 
represented by the absolute terms or paired relocatable terms, or both, 
associated with it. The attribute belongs to the odd relocatable term. 
Complex relocatable expressions are also permitted, lefer to IBH Time 
Sharing System: Assembler Language > GC28-2000. 

In the following examples of relocatable expressions, SIH, JOB, and 
FRANK are in the same control section and are relocatable; PT is 
absolute . 

SAM 

SAH-JOE+FIAIK 
J01-PT*5 
SAH-^3 

Mote that SAM-JOE is not relocatable, because the difference between two 
relocatable addresses is constant. 

Register Notation 

Register notation is an absolute expression enclosed in parentheses. 
The absolute expression, when evaluated, must be some value 2 through 12 
(unless noted otherwise in the description of the macro instruction) , 
indicating the corresponding register. In these examples of register 
notation, PAL is absolute: 

(5) indicates register 5 

(PAL) 

(PAL* 3) 

RX Adress (formerly called "explicit" or "implied" address) 

An address is written in the same form as an assembler-language 
operand: 

a(b,c) 

^ M 

I I I ^base register 

I I ^index register 



L. 



-displacement 



Examples are: 

2(0,5) 

0(2,t|) 

INITIAL 

ALPHA! (4) ALPHAX is indexed by the value in Register 4. 



102 



PageofGC28-2004-6 
Revised 9 May 1 979 
ByTNLGN20-3941 



MOW TO fNTfff MACm INStltUatONS 




i ) 


PAfU OF Ol'f RAND 

CHOOSF ONF 
of A or R 


' 




t 


III « {*••> 


i-1 : 


FNTFRor 
OMIT A 

. u HrpFAr.PP 


...j-j,/.'-'-" . 



iNTOorioted CO 


T,rna. 




^9^-^ 


C^mtion 


0|«imnd 






.^.h 1^^,^.,., [Fi?A<;Fj, i-. Unq,K 



l%*M 


Op»fw»lsn 


OpBrord 






[flilFrj( ^.nl,*, J |.FY=I^Her 



TYPE S OP MACRO INST RUCTION 



for ft«gi|t«ir, G»ntrot#s porofn«t«r» pot«»d is '•filftn 0, I, and, 
Imj frequtntiy, '5. Dow nof g«neratt parwfltttr liit. Uiuolly 
9»m«sro»M linttog* to oootFi«r progrom, Ewtcu'Son Hnm co« b# 
1 .f «, — / j^^ g^^ plae«d !n f«fiit»rii emd 1 ond 



ReCtirr. Data Wl,<jt ;Mf-,„n<jt;..n It retumeH 



Enompiei How >-Oi; might jje t^ie mi 



Of QI^'EHAND FORMS Operand Foftni not expiimnd her* nn» described In the irvdivldool motm deirripHons 



■Nklh* M(»««MI»>or« to b* pfrov\<M hot flr^t b«)*r, 
«> 3 nr«< 112 hn bMrt •qt>o»«d *o 2. 
• •tar*d, rnyiiHf 2 rt>rough 12 moy 

[ • ABSOHITF FXPRF<iMf in 10 

or TEN) FOUR 
^r SAM -JOE 

»TtN«nrf FOUR hoy* b««n «quot»d fo )0 and 4; 

l^iilittMdl X)e or* i»(otdM>f« t«rmi. 

1 REIOCAIABLF EyPBtSSinn C2CAT I 

or CZCATIM 
itZCAt) h th» nome of a HcM Hyjf moy b» 
il wlft»lr« vlrhKil itorog*. A r«locotobl* 
n (bul will rwl i*»e«f«r!ly) b* 
■ fflf lymtiot In on oddnm eonttonf , 



romtFtri foOtronA^ 

cifi»d ; 



fer Sterocj* . C 
fh« porom#»tr» 
Thf## formt: 



»rof#s o porBm«t«r lilt. fUl»d f«rt»rollf wh#r« 

n't fit irt r«s|i«t«r» cmd I.) 

I Stondord [ • denmrnfm both poromdttr lilt and linltop». 

Optmodl may b« In ony form; a bronch around 
thd pommatar liit ii g«r>«rat»d. No MF - 

opcnar^ r»(|uir»d. 

[__t*2!!Lj ' ^'** forwf f«ri«rnt»j only o pofom«t»r lift, no 

•xtCMtobl* cod». Uw»r ii r»^»ort*ibl« for branchir^ 
around Hit, UiiwHy umnI In conjunction with [» 
f0rm, Operandi rmiy bw c^iolutM or rslocatobl* 
•Kpmiioni - ^ niglit«r rwtotlon, or ti^licll or 
•r»ipl!»d ciddr»M. 
RiQUIRED; - SymhoMnntim* neld. 

- K«)rword ap«r«md MF - I . 



E-fomiJ - Ex*cutabl« form; ftnwotw Ifnb^j* oi wt^ m o 
pointer to a parom«t»f lift cr«<rttd by L-form m 
built by wtf . May olto prov!^ or updot* ¥0h»«i 
in porwnettr lift. Optrorxh may be in ony form. 
REQUIRED; - Keyword opmmnd MF - E or MF '= 
(E,list) wh«r« list h either (he 
symbolic oddr«l of th« parxnrmtmr 
lijt (uiuolly th» nnrr» of th# l-form) 
or, with th« oddr*« placed in 
m§hHir 1, (1). 



y»her»" 2 is the ditplocem^nt, i? the indr-x 
nsgiiter. ond 5 Ii die bo«# r*g!jter 

MAUD 
or MAUD .Mi 
where the boje regiiter !» Implied, 1 Hn the 
secortd exomple) U on ind«y reolster, ond the 
forntifin counter vol.* '<( MAUD ii the 
dl«p foremen t. 

• rjiiA.iRFP- 45 
Unlejs itoted otherwise, a d«clmol intesjer I5 impiii 

• TFxl 'THIS ISA MESSAGE' 
A jtring of rhnrocterj encloted by single rninslrfipln 



either 



- nor S-type. 



I CHARACTER STRING- %CR'554AQS 

A Jtring of choroef#f» eontairtlrinf rw imbedded commtn 
or bfonfci or»d not bsglnninj or »r»d'ng with on apntfmphw 

, SVMBtH- START 
C2ATJ! 
ONE 

A »p«cial form of cHoroetef Itrin^ oeceptsb't ir» th^ 
nome field of on oftembler itatem»rtt; 1 to S olpHomefic 
choracten (0-9, A-Z, plw $, 1 , ond ') with firit 
chofoct«r alphobetic. 

. OAIA SET r-JAMF- 

S«* the expfoiwition ift text. 



how to en^or raacro inrtructions 



I sfBbol B&f be a symbolic address ftbat is, a single relocatable 
ters) r such as tbe iiaae af a& iastriictioii in aa asseMbler-laaguage pro-* 
gram, or it aay be a character string ased for identification, not loca- 
tion (sack as tbe ddnaae parameter of a BCB macro instmction) • 

In TSS, the alphabetic characrters are the upper case letters 1-2, and 
f, i, and #• The alphameric characters are the alphabetic characters 
pins the digits 0-9. 

The symbol is written as a string of up to eight alphameric charac- 
ters, the first of which is alphabetic. Embedded commas and blanks are 
not permitted. Symbols beginning with the characters CHD may not be 
nsed, since symbols beginning with those characters are reserved for 
system nse. Szamples of symbols are: 

I L00P12 

? STilT 

I #1 

f 

I Character String 

; A character string may contain any segnence of characters, with the 

I following exceptions: embedded commas or blanks are not permitted. Two 

. apostrophes or two ampersands mast be nsed to represent one apostrophe 

^ or one ampersand in the character string. The character string may not 

I be enclosed in apostrophes. For example: 

J CC#S02GOTaBOS&G0 

i Text 

l 

I I text operand is written as a string of alphameric characters enc- 

I losed in apostrophes. Embedded blanks and special characters are per- 

I mitted. Two apostrophes or two ampersands mast be usb^ to represent one 

I apostrophe or one ampersand in the character string. The text operand 

? may not exceed 255 characters inclnding the enclosing apostrophes. For 

I example: 

-J 

] •1121, PCB, 132, ,1256* 

I Data Set Bame 

i 

I This is the name of one data set or a gronp of data sets. The rales 
for writing data set names are presented below; the types of names that 
may be written for each macxo instmction are under each macro instmc- 
tion 's description. 

fallT qnalified name : Unigaely identifies one data set. 

1. A stand-alone data set name identifies a data set that is neither a 
member of a partitioned data set nor a generation of a generation 
data gronp. The name of a stand-alone data set is written as a se- 
ries of symbols separated by periods. For example: 

MTASIT . THAI. .TBST1 

TERI.HOGEl.LAirBIE 

I.B.C 

The rightmost symbol is the data set's simple name (TESTl, LAURIE, 
and C above) ; the other symbols are gnalifiers. In TSS, for cata- 
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loging purposes, the BaxlaiiB nuBbeir of characters In a data set 
naae including periods, is 35. flie aazianB number of characters in 
anf single qualifier is 8. The Baxiaiui niuiher of one-character 
qualifiers for a one-character name is 17* 

Mote ; Data set nanes created under the XBH OS Operating Sfsteas 
can contain a aaxinun of 4i| characters; if data sets vith names 
greater than 35 characters are to be cataloged in TSS, the user 
should employ the renaming facilitj of the C171JL06 command to 
define a suitable TSS name. 

I partitioned data set and member name identifies a data set that 
combines indiTidual data sets, called members, into a single data 
set* 1^he partitioned organization allovs the user to refer to ei- 
ther the entire data set or to an individual member of the parti- 
tioned data set. 

f he rules for writing the name of a partitioned data set are the 
same as for writing those of a stand-alone data set* 

The rules for writing a member name varf vith each macro instruc- 
tion that can manipulate members. Sometimes (as in LOIB and 
DlLlTl) only the simple member name (a symbol) is written. The 
full name is not required because the user has indirecTtly defined 
the partitioned data set (library) in which the module resides by 
assuring that the library is on the program library list prior to 
issuing those (commands. The user can write 

LOIB SOITI 

if he has previously entered SOETl in a library currently on the 
program library list. 

In other macro instructions (for example, CDS) , the user must give 
the fully qualiLfied member name. This consists of the name of the 
partitioned data set suffixed by the simple member name in paren- 
theses. For example: 

HQl (OMITBI) 
G.H.IB (B) 

Here HQV and G.H.AB are partitioned data sets with members OlSTll 
and H, respecrtively. 

The name of the partitioned data set is written with the same rules 
as for a stand-alone data set. The parentheses and member name are 
considered as an appendage to that name. The maximum number of 
characters in a member name is 8. 

Generation names identify data sets that are part of a generation 
data group. These data sets €mm be referred to absolutely or 
relatively : 

^» Absolute generation names are written as the name of the genera- 
tion data group followed by a period and the characrliers 
GxxxxVyy, where xxxx is a four-digit, decimal, generation num- 
ber, and yy is a two-digit, decimal, version number. For 
example : 

miST .Llllfi .TT .GOOO 1V00 

HJ.LI4.iV.60003¥01 

HIlQ.G01i|7?03 
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The characters GxxxxVyy are considered a fixed-part of the over- 
all name. The naae of the generation data group is a partially 
gnalified name applicable to all generations in the group. 

If the generation is a partitioned data set, a meatier (for exam- 
ple, JOl) within that data set is referred to as follows: 

I.B.C.Gxxxx?77 (JOB) 

b. Relative generation names are written as the name of the genera- 
tion data group followed bf the appropriate relative generation 
number enclosed in parentheses: 

6.B.G(0) 

The relative generation number of the «ost recent generation is 
(0) ; the generation just prior to that is (-1) ; the one before 
that is (-2), etc.; and a new generation to be added is (^1). 
For example: 

G0ST.1I0.I,19P(+1) 
GOST.0O.I.19F(-3) 
llQ.T.L5.SiriH(0) 

If the generation is a partitioned data set, a member within 
that data set is referred to as follows: 

SEAT (-3) (JOE) 

where JOB is the member in gnestion. 

Partially qualified names : Refer to all data sets having the partially 
qualified name as their common higher-order qualifier. 

1. A generation data gronp name is the name that is common to each 

generation in the gronp. Generation data group names are restrict- 
ed to a maximnm of 26 characters including periods. 

2« Another partially gnalified name can also be used to refer to two 
or more data sets. For example, the partially qualified name GO. 
AB1«^ can be used to refer to both of the following data sets: GO. 
AB14.A and GO.ABIil.B. If these were the only two of a user^s data 
sets with the same higher-order qualifier, ^.ABI^, and he wished 
to erase them both, he conld do so by specifying G0.AB14 in the 
BBASE macro instruction. 
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SBCTIOl 2: SYSfli MICIO IlSTlUCTIOl DESCBIFYIQIS 



ADDEV — Add Device to gask SYMbolic Pevicre List fBI 

Tke IDBl? aacro instruction aMs an I/O device to your task's sf»l>ol- 
ic device list. 

I 1 -1 • ^ ^ ^ 1 

llaae {Operation (Operand I 

I 1 „^ ^ — ^ . 1 

|[sfabollfIDDl? |[ device] I 

I 1 ^-1 ^ ^ , 1 

device 

specifies the syabolic device address of tke particular I/O device 
you want added to your task's symbolic device list (ISBL) • 

Specified as : I niuiber assigned by your installation as the devi- 
ce's symbolic devicre address in register notation (2 tbrongb 12) • 
fbe number must be loaded into the specified register before issu- 
ing the macro instruction* 

Default : It is assumed that the issuer has placed the symbolic 
device address in register 0. 

Execution : The resident supervisor adds an entry for the specified sym- 
bolic device address to the task's symbolic device list. If the device 
is already in the task's symbolic device list^ the count of the number 
of times the device has been added is increased by 1; if this count 
exceeds 15 an error is indicated. 

Bet urn Data : The resident supervisor sets the high -order bit of regist- 
er to 1 if the count of the number of times the device has been added 
exceeds 15. 

Example : Suppose you want to add symbolic device 17 to your symbolic 
device list, fou might write: 

LH 2^=1 C17) 
ADD ADDEV (2) 



ADDPG — Add Virtual Storage Pages fBI 

The ADDPG macro instruction is used by the system to properly main- 
tain the status of a task's page and segment tables. It adds contiguous 
pages to a task's virtual storage and creates any necessary page table 
and external page table entries* A GETHAII request for virtual storage 
causes an ADDPG to l^e issued. 



1 ' - ^ j ^ 

Hame | Operation |l Operand 



I ADDPG I 



Bote ; There are no operands. 

Initialization ; Before the ADDFG macro instruction is executed, the 
issuing program must set up the following general registers: 

Begister (si Contents 

B0-B1 Beserved segment name (BBAHE) , if any 

B15 Flags, protection code, count of pages requested 
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Thm foiniat of E15 is: 



I flags I protection | count of pages | 

I I code I I 

I 1 1 I 

12 

vhere: Flags Meaning 

I»01» variable regnest 

X»02» system program regnest 

Xi02|i return code regnested 

X»i»0» MIHl given 

Protection Code Meaning 

non-privileged read/vrite pages regnested 

1 non-privileged read onlf pages regnested 

2 privileged pages regnested 

Bxecntion ; lew page table entries and, if necessarft segment table 
entries are constructed. Tbe number of page table entries to be con- 
structed is determined bj the page count contained in register 15. Tbe 
second bfte of register 15 is used to determine tbe setting of tbe 
storage kejs for all tbe pages being added* 

Return Data ; If a return code kas been regnested., register 15 contains 
the following codes: 

Code Meaning 

allocation done 

ft reguest not satisfied 

Otherwise an extended program interrupt is engueued on the task for the 
•reguest not satisfied* return, fbe virtual memorj address of the first 
page allocated is returned in general register 1. 

Programming Bote : Page allocation for privileged programs is from the 
top of virtual memorj down* Page allocation for non -privileged programs 
is from the bottom of virtual memorj or the bottom of the BV1M2 area up. 
If PICKSIG is SXSGlSed, pages are allocated without respeet to anf boun- 
darj alignment. If PICKSIG is not STSGBVed, non -privileged program re- 
guests are alloc^ated on 16 page boundaries for reguests that are mul- 
tiples of 16 pages and on 256 page boundaries for 256 page reguests. 

the systems programmer should use the GSfHIIW macro instruction describ- 
ed in Assembler User Maca^ro Instruction , GC28-200ft, to allocate virtual 
memory to a task. 

Example : Assume that 100 pages of virtual storage are to be allocated 
with non -privileged, read only protecrtion keys. The following instruc- 
tions might be written: 



SI 0,0 NO BIAMl 

SB 1,1 10 BVAME 

LA 15,100 PAGS COOIT 

15,=A(X»00010000») PBOTBCTIOl CODE 

O 15,=A{X*0ft000000») BITUBV CODl BEQUBSTID 

ABBPG 
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IDgPS " Md Sli^yei firtaal Storage Pages (Bj 

The IBSPe aacro l&stracrtion is used bf tlie sfstea to add shared pages 
to a task's Tlrtaal storage and create any necessarj shared page, seg- 
■ent, and auzillarj segaent table entries. The 1I>SP6 aacro instraction 
is issaed hj the sfstea to aaintaia the statas of a task's segaeat and 
shared page tables. The sjstea prograaaer shoald ase the 6STS1AI1I entrj 
point (CZC6Jk6) in ¥11 to obtain shared wirtaal storage. 



I 1 "T ^ ^ 1 

llaae {Operation {Operand { 

I , -4 1 

|[s7abol]|lBSP6 { ( 

I 1 ^-j ^ ^ 1 

lote: There are no operands. 

Initialization ; I BCLISS aacro instracrtion vith the P11T1I.B6BD option 
amst be coded in a CSBCT prior to coding IBSPG. If aore than one I^CLkSS 
aacro instracN:ion is issued in a aodale, the last BCIASS issued prior to 
coding IDSP6 aust be issued vith the P1I¥1I.BG£B option. Before the 
ADSPG aacro instruction is executed, the issuing prograa aust set up the 
following general registers: 

Beqister Isl Contents 

BO protection code 

Bt count of pages reguested 

B15 zero or cx>nne€rted shared page table nuaber 

where: 

Protection Code Meaning 

non^priwileged read/write pages reguested 

1 non-privileged read onlj pages reguested 

2 privileged pages reguested 

Bxecution : The nuaber contained in bftes 2 and 3 (the low-order bytes) 
of register IS is used to deteraine if pages are to be added to an ex- 
isting shared page table or if a new shared page table is to be con- 
structed. Xf bftes 2 and 3 of register IS are zero, or if there are not 
enough pages reaaining in the shared page table indicated by bytes 2 and 
3, a new shared page table is constructed. Once the shai^d page table 
is selected or c^onstructed, a nuaber of page table entries corresponding 
to the nuaber contained in register is added to it. Storage protec- 
tion keys are assigned as reguested by the code in byte 3 of register 0* 

Betum Data : The following data are returned in general registers: 

Becristerfsl Pata 

BO (bytes 0-1) relative page nuaber within shared page table 

BO (bytes 2-3) shared page table nuaber 

B1 address of first page allocated 

BIS - allocation done 

H - reguest not satisfied 

Proqraaainq lote : lllocation of shared pages is controlled by two 
variables: 

1. Connected StT# given as input 

2. POBSBG specified at srSGBB 

The following rules govern allocation: 

a. lllocation of shared segaents is froa top of virtual aeaory 
down. 
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b. Illocation of pages vithiii skarad segments is from the bottom 
up. 

c. Pages are allocated in the SPTi given as input. 

d. If "c* fails or if an SPT# was not given^ pages are allocated 
in any existing SPf# if PUBSEG was SfSGEled. 

e. If "d" fails or if PUBSBG was not SYSGlIed, pages are allocated 
in a new SPTi. 

Example : Suppose two shared non-privileged read onlj pages are to be 
added; assume the shared page table number is X*FFF3*. The macro in- 
struction might be written: 



LA Q,% PEOTECTIOI COBB 

Isk %,2 COUIT OF FIGBS 

L 15,=I{X»0000FFF3») SHIREB PAGE TABLE IBHBEl 



ADSPG 



w 



ATPOL — Poll for Pending Attention Interrnption iO\ 

ATPOL is used to find out if there is a pending attention (task- 
asynchronous I/OJ interruption (this would be caused by a conversational 
user hitting the ATTM key) ; if there is^ control is transferred to the 
address specified by the branch address operand. 

P 1 p, J 

IVame | Operation | Operand | 

I 1 1 1 

{[symbol ]| ATPOL | branch address[ , switch ] | 
t i I I 

branch address 

specifies a point in a program to receive control if there is an 
attention pending. 

Specified as : An RI address. 

switch 

specifies the address of a byte whose contents are to be tested. 
If this byte is set to X»00», the test for a pending attention will 
be made; if other than X*00"^ no test will be made for a pending 
attention and control will pass to the instruction following ATPOL. 

Specified as : An RX address. 

Befault: The test for a pending attention is made. The issuer 
must have previously defined the symbols ISAAT and ISAATH in his 
program by copying the DSBCT CHAISA (interruption storage area) 
from the system macro/copy library (SfSHAC) . 

AOXPG — Extract Auxiliary Storage Page Counts 101 

ABXPG is used to determine the number of auxiliary drum and disk 
pages currently available in the system. 
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J 1 ^^ ^ . 1 

flaae | Operation | Operand I 

I 1 1 ^ . _ 1 

ICs7Bbol]iIUXP6 I I 

I i 1 ^ ^ ^ . 1 

Bote s There are no operands • 

Execution s This macsro instruction generates an S¥C 230 instrnction, 
vhick extracts the mnnber of anxiliarj drnii and disk pages froa the 
anxiliarj storage allocation table header » These o>nnts are returned to 
the user • 

Betnrn Data s 

le^ister - Count of nnnsed drna pages. 

Register 1 = Connt of nnnsed disk pages • 

Bxaaple s h sjstea prograaaer, coding a aodnle that services regnests 
for storage, vants 1;o find the nnaber of nnnsed pages that are available 
for assignment ; he can codes 

STOEG lOIPS 



AOXSgT — Create Overload/Overdraw Interrnption Control Blocks fOI 

The inxsiT sacro instrnction creates . interruption control blocks to 
handle interruptions issued bf the resident supervisor when either the 
task overdraws its anxiliarj storage allocation or a system overload 
condition does not pernit allocation of the amount requested. 



I 1 r^ ^ 

I Vase I Operation | Operand 



|[sjmbol]|AIIISlT I 

I 1 L. 



Bote s There are no operands. 

Execution s Two interruption control blocks are created in the issuing 
prograB*s PSECT. These will service interruptions issued bf the resi- 
dent supervisor either (1) to warn a task that it has overdrawn its 
auxiliary storage allocation, or (2) to cut off a task in an overloaded 
system in order to relieve a shortage of auxiliary storage. The inter- 
ruption control blocks are created in the macro expansion and enabled at 
task LOGOB. Servicing of interruption (1) consists of issuing a warning 
message to SfSOUT. Servicing of interruption (2) consists of issuing a 
logoff message and a completion code 3 IBEBD. 

Programming Botes s Use of the lUXSBT macro instruction is restricted to 
the LOGOB system module. 

Example s 

BIME leiSBT 

AflPX — Available Amxiliarv Remaining Count fll 

The IVAUX macro instrucrtion is used to compare the amount of auxi- 
liary storage required by a user with the amount available in the sys- 
tem, and to cause a branch to a desired location if enough space is not 
available. If space is available, the current amount of auxiliary space 
available is updated. 
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I 1 1 

I Vaae | Operation lOperands 

I 1 1 ^ 

I [ sf Bbol ] I kWkXH. I [ aaount. address , Jloca-tiom 

• I 1 



asounl; address 

specifies an address containin? tlie munber of pages (expressed in 
binary) of anxiliarj storage required bf tbe user. 

Specified as ; In IX address, or register notation • If register 
notation is used, the amount address Bust be loaded into the speci- 
fied register before issuing the aacro instrucrtion • 

Default ; fhe Talue contained in SCHHI? in sjstes cobbou is used; 
this Talue represents the aaxiBUB aBount of auxiliary storage al- 
lowed at your installation* 

location 

specifies the address to vhich control is passed if sufficient 
auxiliary storage is not available for the task* 

Specified as : In IX address. 

Initialization : I BCI.ISS macro instruction with the FlIflLlGED option 
Bust be coded in a CSECT prior to coding I¥IUX. If Bore than one DCXISS 
macro instruction is issued in a Bodule, the last DCLISS issued prior to 
coding lYIUX Bust be issued with the PRIflLSGlB option. 

The CHISXS and CHISCH DSECTs BUst be copied into the issuer's Bodule 
and covered with base registers. 

Execution: If the asount operand is not specified, an installation 
value is obtained froB field SCHilY in systeB cobbou. If the aBOunt 
operand is specified, the value at the specified location is coapared 
with the aBount of auxiliary storage currently available, as recorded in 
the systeB table CHBSIS. If the amount required is greater than the a- 
Bount available, control is passed to the indicated loiration. If the 
required space is available, the auxiliary space is allocated and the 
aBount currently available updated to reflect this request. 

Example : fhe aBount of auxiliary storage required by a task has been 
prestored in register 5. The Bacro instructions 

CHECK 1 IflUX (5) ,lS€t 

will update the aaount available, or transfer to ISG. 



BHSG — Send BOLKIO Message 

The BHS6 macro instruction is used only by the BULIIO task to send 
Bessages froB the BULKIO Bessage file to the operator. 

r ' """ ' 1 ^ 1 -^ 

I HaBe I Operation | Operand I 

I 1 1 1 

|[syBbol3|BHS6 (address of Bessage id, [¥1, ¥2 •••¥n],[ Bessage type] | 

I — , 1 1 ^ ^ 1 

address of Bessage id 

specifies the address of a location which eontains the external 
address of a Bessage defined within the BIII.EIO Bessage handler 
(CZIIH) module. 
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Specified as : am absolute address. 



Pi:oqi:a»aiiiq Mote ; the eight byte message is declared as am eatrf point 

vithin the aodnle CZIll and has tbe folloving forsat: CZJLWSfi wbere $ 

is tke BOLKIO section id (obtained fros use of tbe IB macro) and ## is a 
two-digit number from 00-99. 

¥1,12. ..fn 

specifies information tbat is to be used to complete or alter tke 
message being sent to tbe operator. ThB information is substituted 
for variables (X...X) in tbe message text. 

Specrilfied as : register notation or an absolute address. 

message type 

specifiLes where to send the message. 

Specified as : register notation ^ or an absolute expression as 
follows : 

- write to operator (also write to log) 
L - write to log 

1 - write to operator and log 

I - write to operator and log and r je 
1 - write to log and rje 

Default ; O 



Example : 



BH S6 HS6I]>, ( (B2) , (13) ) ,1 



HSGID DC V(CZAIAOI) 

Use of this macro would send the message CZIWIOI as defined in CZIWB to 
the operator, system log, and IJl acknowledgement dataset. Before send- 
ing the meiasage the variables pointed to by registers 2 and 3 will be 
substituted for the %s within the message. 



BPKD ~ Create a Builtin Procedure Key (01 



Mote: This macro has been replaced by BPKBS and must not be 
used for mew code. This documentation is retained only to aid 
in maintenance of existing programs. 

The BPIB macnro instruction is used in conjunction with the BIIII.TI1 
command to identify a user-coded routine that is to process a user- 
defined command issued at a terminal. The user-created command must be 
assigned a name by the BUILTII command (see Command System User's 
Guidel . 



• i 1 

I lame | Op eration | Operand 

-I 1. 



I symbol 

I 



IBPKB 

■■ 



i en try point name[ , (keyword address,...)] 



Mote : k symbol is required in the name field. 

entry point name 

specifies the symbolic name of the entry point to the user-coded 
routine to be executed when a command, named by a BUILTIl command, 
is issued at the terminal. 
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Specif i ad as r I sjnliol (one to eiglit alphameric characters, the 
first of vhich Bust be alphabetic) • 

kejvord address 

specifies the address of a kejvord that identifies an operand that 
is to be specified vith the iiser*created comaand* Each such kej- 
vord defines both the position and the external kejword of a par- 
ticular operand of the connand* 

lach ttser-coded kejword consists of a BC containing the ke7word 
word of the operand being defined. Each snch DC nnst be preceded 
bf the length (one bf te) of the character string in the DC (see Ex- 
ample belov) • Ilthough each BC contains this keyword specifica- 
tion, the actual operand, when specified during connand issuance at 
the t^tainal, need not be indicated by keyword; it can be specified 
positionally. 7he position of each keyword specified within the 
BFKB macro Instruction determines the position of the operand when 
positional notation is nsBd.» 

Specified as : I relocatable expression. 

Programming Wotes s Buring assembly, the BPKB macro instrucH:ion 
generates a table containing linkage information and parameter storage 
areas for use by the BBILTIH command asso<2iated with the macro instruc- 
tion. The table contains pointers to the object module that is to proc- 
ess the command. This module is referred to as the command processing 
routine. The table also i^ontains adi^ons pointing to each of the keyword 
defining constants coded by the user* The number of parameters that may 
be specified in a command is determined by the number of dummy parame- 
ters defined in the BPKB macro instruction. Space is reserved in the 
table so that pointers to the parameter values specified by the user 
command at the terminal can be recorded. 

In EVTlf statement is generated in the table for the symbolic name of 
the BPKB macro instruction. The recorded entry address is then used to 
establish linkage between the user-coded module and the BOIITIH command 
that defines that module as a command processing module and associates 
it with a particular command name. When the named command is issued, 
pointers to the actual values of any positional or keyword parameters 
specified at the terminal are placed in the reserved storage areas with- 
in the generated table in the PSICT that contains the BPKB macro in- 
strucrtioni register 1 is then set to point to these pointers so that the 
data can be referred to by the command processing module. If any com- 
mand operand defined by BPKB is omitted when the command is issued at 
the terminal, these pointers are set to point to any default values; if 
none exist, they are set to zeros. Control is then passed to the com- 
mand processing module which is executed using the necessary parameter 
values to accomplish the desired goal. 

If no parameter names have been defined in the BPKB macro instruction 
(indicating that no parameters are to be specified when the command is 
issued) , the expansion of the macro instruction does not set up dummy 
parameter areas or allow specification of parameters within the command. 
Examples of the table generated by BPKB are shown below. 

The BPKB macro instruction must be supplied in a PSSCT and must have 
any expected parameters defined therein. If the command processor is 
assembled in a module different from the one containing the BPKB macro 
Instruction, its entry point and PSSCT symbols must be used as arguments 
of an EXTll statement in the assembly cxintaining the BPKB macro 
instruction. 

When a user wants to provide parameters for the command he is creat- 
ing, he must provide €x>de in the PSBCT (for each such parameter) indi- 
cating a keyword to be associated with that parameter and the length of 
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tliat cliaracrter string* The parameter addresses o£ the BFKB aacro in- 
struction nnst also be the naae fields of the user-defined character 
strings C^^hat isr FA11 DC C'KBTIOID*^ where Pill is a parameter address 
for BPKD) . It is these parameter strings or kej vords that will be asso- 
ciated with the parameters of a calling command when the command is 
issued • 

Example : If a user wants to execute the object program instrucrtions in 
a particular CSECT when a command called tlOf is issued at the terminal, 
he could indicate this by specifying the following in a PSECT associated 
with the command-processing module: 

BPKIIBBI. BPKB SPPIOC, (BPA11,nPAR2) 



BP111 
BPIS2 
It the terminal: 



BC llip.»BPtll) 

BC C»KEI101B1» 

BC 11.1(1 •DPI12) 

BC C»lBfl01B2» 



COBIB BY USEE FOE ALL 
BESIIEB COMMA MB 
OFSIAIBS 



BO ILTI 1 TIOT , BFKLIBEL 

TIOT KBTWOIB 1=^70, EEriOlB2=5O00 

Cor, if positional parameters 
are desired) 



rio^r 



70,5000 



When raOT is issued, pointers to keyword and positional parameters 
are placed in areas reserved within the BFKB macro expansion, making 
them available to the command expansion routine located at entry point 
CSSCTHOB. The routine at CSSCTIOB is entered, with register 1 pointing 
to a list, which contains full word address pointers to the actual param- 
eter values entered at the terminal (the length of these actual values 
can be found in the byte preceding the value location) ; then the routine 
is executed and control is returned to the user terminal* 

BTBOBL — Set Last trailed IB into BULKCOMH and S -entry Table 

The BTIOBL macro instruction moves an 8 byte external call id into 
the BULKCOMM and S-entry tables* This external call id will be used by 
the BULKIO abend recsovery routine (CZAIA) for purposes of re<»>very when 
an error has occurred and ABBIB has been called* 



I Hame {Operation | Operand 
I , ,. 



|[symbol]|BTB!IBL Icontinuation address, module last called 

I 1 i. . 



con tin ua tion address 

specifies the point at which procressing will continue when control 
is returned* 

Specified as : an SX address 

module last called 

specifies the name of the external routine called by a BULKIO 
module before ABEIB was called* 
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Specif! efl as ; an 8 cliairacrter absolute expression o£ wliicli tlie 
first two characters Bust be eitber ••▼-» (for a Vli call) or »!i-w 
(for am HS&H call) • 

Sxajuele: 

BTBOBL E0DAI>,=CL8"V-G1T» 

-^ H¥C S1T7C01T,-JI (SOBI) save continue address 

♦ 1?C BI.TClI.Ly=CL8»V-<51T* 

Initialization ; Ion »nst provide tbe following BSBCTS in order to use 
tbis Bacro instruction : CH&BC7 B CHASST. 

CAICL " Cancel Bealtime Interrnption fOI 

Tbe C&ICL aacro instruction peraits privileged resident programs to 
speciff tbat a specific realtime interrnption regnest (for exanple, one 
regnested bj tbe SlTTIHll sjsten aacro instruction) be canceled. 

I r i 1 

I lane {Operation {Operand I 

I 1 1 1 

|[sjBbol]|CIHCL [[return parameter], interrupt ion routine adcon | 

I 1 1 ^ 1 

return parameter 

specifies tbe return parameter previously specified bf a SSTTinsi 
macro. 

Specified as s legister notation (0 tbrougb 15) . Tbe return param- 
eter must be loaded into tbe specified register before issuing tbe 
macro instruction. 

interruption routine adc^n 

specifies tbe entry point of a module, previously specified by SBT- 
TIHEB, wbicb would bave received control at time of tbe interrup- 
tion if it was not being canceled. If tbis parameter is set to 
I"FFFFFFFF«, all interrupts for tbe given return parameter are can- 
celed. Tbis type of call is used by BILBTB TSI (ClAHB) . 

Specified as : I symbol, or register notation (1 tbrougb 15) • If 
register notation is used, tbe entry point must be loaded into tbe 
specified register before issuing tbe macro instruction. 

Initialization ; All modules using tbe CAICI. macro instruction must 
first bave a copy of CHlPSli and a USIIG CHIPSJl statement. 

Execution: CIICL cbecks wbetber tbe interruption routine's adcon was 
specified; if not, an error is declared. Type-1 linkage is used to 
brancb to tbe Set Mealtime Interruption routine wbicb deletes tbe real- 
time value associated witb tbat return parameter from tbe realtime- 
interruption -pending gueue in tbe resident supervisor. 

Bet urn Pata ; legister 15 is set to I»OC« for normal returns. 

Begister 15 is set to X'08» if tbere was no entry to 
CIHCL. 

Example ; Tbe realtime interruption previously scbeduled by a SETTIHEB 
macro instruction for tbe TSI wbose address is in TSIBEG, witb tbe in- 
terruption servicing routine of CEAHl, is canceled by issuing: 
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OKAlk 



CliCI. 



TSI116,C1JIH1 



CBAM61 — CkaBcre Schedule fable latry fll 

Thm CHAHGl Bacro instimctioii perftits jon to alter tlie schedule table 
emtry (STB} le^el ot a task to desired level and to retrieve the current 
level. If the new level is valid, it is placed in the task's TSI. 



■ " ' " """ 1 ^-T ^ 

llaae | Op era tionf Operand 

I 1 ^+ 



|[sYBbol]|€HA161 | level 



level 



specifies the address of a fnllvord containing the new schedule 
level. 



Specified as s In IX address, or register notation, 
is saved if register 15 is specified* 



Execution tiae 



Bote s If register notation is used, the new schedule level value 
itself (not its address) must be loaded into the specified register 
before issuing the macro instruction. 

Initialization s k PCLASS nainro instrucrtion with the F1IVII»161D option 
must be exuded in a €SBC!P prior to coding CHA16B. If more than one 
1>CI>ISS nacro instruction is issued in a nodule, the last DCI.ASS issued 
prior to coding CHIISB nust be issued with the F1IVI1.S61D option. 

Execution s fhe new schedule level is passed to the resident supervisor 
in register 15. this level represents an index position (0-255) within 
the resident supervisor's schedule table. When the supervisor receives 
the interruption, a check is nade to determine if the new schedule leve- 
lis valid (that is, within the schedule table limits and a nonzero 
entrj ) I. If valid, the task's schedule level is changed to the value 
specified in register 15. If not valid, an error indicator is set in 
register 15. The ctirrent schedule level is alwajs returned in register 
15. 

Bet urn Data s fhe format of the return information in register 15 iss 





- r-T-T — 




— 1 


— r 




— n 




1 1 1 




1 


1 




1 




1 1 1 


Old 


1 


1 


New 


1 




1 1 i 


level 


1 


1 


level 


1 




L-X-J. — 




— >_i. 


-r- „,■.,,. .,..._ .,4 . . 




4 



15 16 



23 2^ 



31 



validitjf 
byte 

Validitf bfte values s 



always 
returned 



Setting 
111 zeros 



Heanincr 

lew level is valid. 



Bit 6 (on) Outside the limits of the schedule table. 
Bit 7 (on) Zero entry was specified. 
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Bxanple ; Suppose you wish to change tlie current level of a task to 
index position 10. Ion write: 



LI 15,10 
CHGEL CHIMCiE (15) 



CHPIIIHIA — Generate Tvpe-1 or Type-2 linkage CQI 

fhe prinarj function of tlie CHDIlllI inner macro instruction is to 
generate a type-1 or a tfpe-2 linkage or to generate a linkage bf aeans 
of an SVC. It maf also be used to load registers and 1 with parame- 
ters or load the second element of the IF sublist in tbe B-form of the 
S--type macro instruction. 

I 1 1 1 

I Name | Operation {Operand | 

I 1 — ^ 1 1 

([symbol ]|CHDI1I1SA ([parameter 1 ]y[parameter 2 J, | 

I J I [ ([sublist element l],[sublist element 2])] | 
I I I [, enter code, macro code] | 
I 1 1 1 

parameter 1 

specifies a parameter to be loaded into register 1. 

Specified as ; In RX address. 

Default ; It is assumed tbat any desired parameter is already 
loaded into register 1. 

parameter 2 

specifies a parameter to be loaded into register 0. 

Specified as : In IX address. 

Default ; It is assumed tliat any desired parameter is already 
loaded into register 0. 

sublist element 1 

is tbe first element of a two-element sublist. If specified by 
itself, it designates the entry point for a type-1 linkage. If 
specified together with the second element, it indicates the rela- 
tive byte location within the DCB at which OFIH has placed the 
R -value . 

Specified as : The name of an entry point (if sublist element 2 is 
omitted) , or a number or absolute expression (if sublist element 2 
is included) . 

Default ; Sublist element 2 is interpreted as specifying the 
operand of an SVC instruction. If sublist element 2 is also 
omitted, no linkage is generated. 

sublist element 2 

is the second element in the sublist. If it is specified by 
itself, it is interpreted as the integer specified in the operand 
field of an SVC instruction. If specified together with sublist 
element 1, it is interpreted as the relative byte location of the 
V-value within the DCB. 

Specified as ; I number or absolute expression. 
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Default : Sublist element 1, if present ^ is interpreted as an entrf 
point for tjpe-l linkage. If snblist eleaent 1 is also omitted, no 
linkage is generated. 

enter code 

specifies the enter code (see Appendix A) to be nsed in generating 
a type-2 linkage. 

Specified as : A number or an absolute expression. 

■aero code 

specifies a code ti3 be stored in tbe macro code field (lAClF) of 
tbe BOB. 

Specified as : One of the codes explained under tbe lAClF^^ operand 
of the BCB macro instruction (see Assembler Oser Macro 
Instrnctions } . 

CAOtlOM : Since tbe omission of botb snblist elements results in no 
linkage being generated ^r fon must fnrnisli at least one snblist element 
vben using CHDIMHIA to generate a tfpe-2 linkage. In addition to pro- 
viding the enter erode operand, yon must also provide a dummy entry point 
in a sublist element. 

The macro o>de must be specified only vhen the outer macro instruction 
has a DCB address to be placed in register 1. Also, parameter 1 and pa- 
rameter 2 may be used only vhen the value to be loaded into the appro- 
priate register can be Esed as the second operand of an LA instruction. 

Example A ; The macro iu struct ion : 

.LIIK CEDIlllA ,, (C2CXI2),1»FF» 

results in the generation of either a type-1 linkage to CZCIYZ or a 
type-2 linkage to that routine with an enter code of ^55, depending on 
the privilege class of the issuing module. This determination is made 
by testing the value in SCHBCLS. 

Example B ; The coding: 

EFOIH CBDIIIIA HF(2) 
results in the second element of the lF=operand being put in register 1. 
Example C : The macro instruction: 

11101 CIBIIIIA ,,(,254) 
results in the generation of SVC 254. 



CHgyiOCK — Exchange WE locks fOl 

The CHGVLOCK macro instruction is used to exchange VH locks vhen 
processing a chain of inflividually-locked control blocks. 
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I 1 'I ^ • 1 

flase rOperatio&IOpeirmiid I 

I 1 1 ^ ^ 1 

|[sfBliol]|CH6fL0CK |lof1rlog2 | 

I I I ^ ^ . ^ I 



log 1, log 2 

ide&tif 7 tvo ¥M I»oclcs to l»e ozelia&ged* 

Specified as ; tlie sjabols naaing I.06TL0CK aacros* 

Exectttion ; fhe acrtlTe areas o£ tlie specified ft Lock AQchors will be 
ezcliaiiged* 

CAOTIOM ; fkis macro aiist be protected from task interriipts bf ITI/FTI. 

PrograMBing Bote : lefer to VI locking in Seirtioii 3. 



CLOSE fMS&HI — Disconnect Data Set Fron Pser's Froblea Procrraa fSI 

Tbe CLOSE macro instruction disconnects one or nore data sets froi 
tbe nser*s problen program. 

Standard form: 



I 1 't 

t lame | Op eration | Operand 

I 1 fr- 



it sfmbolJI CLOSE i (deb address, •».} 



L-f orm : 

i "1 1 ^ ^ ^ ^ ^ 1 

(lame | Op eration | Operand | 

I 1 1 ^ ^ 1 

I sjmbol I CLOSE i [ Cdcb address, • . .> , ]HF»L | 

I I I ^ ^ , I 

Vote: I sfmbol is regnired in tbe name field of tbe L-form. 
E-form: 



I 1 1 

I name | Operation I Operand 

I 1 1- 



I [symbol] I CLOSE I[ (deb address,. ••), pf= fB, list) 

I 1 M ^ 



Bote : If a deb addiress is not specified in tbe L-form, it must be pro- 
vided vitb tbe B-form. If spe€dfied in both, tbe E-form operand over- 
lays tbe corresponding operand in tbe L-form. Vo more deb addresses may 
be specdlfied in tbe E-form tban were specified in tke L-form. 

deb address 

specifies tbe address of tbe data control block opened for tbe data 

set wbose proc^sssing is to terminate. 

Specified as : In the standard and L-form, as a relocatable expres- 
sion; in the standard and E-form, in register notation (2 through 
12) ; in the E-form only, also as an IX address. If register nota- 
tion is used, the deb address mast be loaded into the specified 
register before issuing the macro instruction. 

C112I0B: The following errors cause the results indicated: 

Soction 2: System Macro Instruirtion Descriptions 121 



I Error | Besult 

I ^ 

I Closing data control block tkat is already closed. IHo action 

I 

I Closing when deb address operand does not specify 

(address of data control block. |Task terminated | 

I 

(Closing data control block containing invalid DSOH6 

(specification. (Task terminated ( 

I ^ 

Procrraaming Botes : Yon may specify any number of data control block ad- 
dresses in the CLOSl macro instrnction. This facility makes it possible 
to close data control blocks and their associated data sets in parallel. 

In most instances, the FIIISH macro instrnction should precede CLOSE 
(see the eiqplanation of the FIIISH macro instrnction in "Macro Instinic- 
tions for IS II") , since yon cannot be informed from CLOSE of errors that 
may have occurred in processing the last output buffer page. Addition- 
ally , the use of CLOSE without a preceding FIIISH that returned a normal 
completion code would cause the task to wait until the I/O operation for 
that DCB is complete. 

The CLOSE macro instruction for ISAM releases all the storage area 
that was used for HSIH. The options of lElEAB and LElfE are ignored. 
If the FimSH macro instruction does not precede the CLOSE and if the 
DCB IlHHSGssO , a message is written to the operator to remove the data 
set from the device. If the DCB COIBIHE flag is set and if a FIIISH 
does not precede the CLOSE, a card is read from the reader on the same 
2540 as the selected punch and stacked in pocket 3. 

CLRVLOCK — Clear a ¥M Lock (0) 

The CLlfLOCK macro instruction is used to open a ¥M Lock during 
abnormal termination recx^very by a module which uses other xxxWLOCK 
macros. 



I — : J J 

I lame | Op eration ( Operand 



I [ symbol ](CL1?L0CK (log 

I 1 ^ — I 



log 

specifies the ?1 Lock to be cleared. 

Specified as ; the symbol naming a LOGfLOCK macro. 

Execution ; The specified ¥H Lock Anchor is examined, and the equivalent 
of OPHYLOCi: is executed if the lock is indicated as "set". 

CAOTIOI; This macro must be protected from task interrupts by ITI/PTI 
unless used in a standard ABBWB Interlock lelease routine, in which case 
the All call will be made with task interrupts inhibited and no ITI/PTI 
should be attempted. 

Froaramminq Bote ; lefer to ?1 Locking in Section 3. 

CBSE6 — Connect Segment to Shared Page Table fBI 

The C9SE6 macxo instruction is used by the system to connect a seg- 
ment table entry to a shared page table. 
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I 1 ' T ^ ^ ^ ' 

llaae fOperatloii fOperand 

I , ^-1 ^ 

ICs7Bbol]|CSSB6 |[segBeiit niiBber,sliai:ed page table number] 

I I — * 



segae&t nuaber 

specdfies the segment table entry to be connected to tbe shared 
page table. 

Specified as : In absolute expression or register notation (1 
tbrongb 12) • If tbis operand is specified, tbe shared page table 
nnnber operand snst also be specified. If register notation is 
used, the segment niinber shonld occupy the high*order half word of 
the register. 

Default : It is assnned that the issuer has placed the segment num- 
ber in the high-order halfvord of register 1. 

shared page table number 

specifies the number of the shared page table to which the segment 
is to be c^onnecTted. 

Specified as ; In absolute expression or register notation. This 
operand must be specified if the segment number operand was speci- 
fied. If register notation is used, only one register may be spec- 
ified for both this operand and the segment number, and the shared 
page table number must be placed in the low-order halfword of the 
register. 

Default ; It is assumed that the issuer has placed the shared page 
table number in the low-order halfword of register 1. 

Initialization : I DCI.ISS macro instruction with the FBIflLlGED option 
must be coded in a CSlCIf prior to coding CISIG. If more than one DCIISS 
macro instruction is issued in a module, the last DCLISS issued prior to 
coding CNSE6 must be issued with the P1I¥ILS61D option. 

Execution : The shared page table number in the low-order halfword of 
register 1 is used to search the task's auxiliary segment table. If an 
auxiliary segment table entry is already connected to the shared page 
table, its segment number replaces the high-order halfword of register 
1. 

If no auxiliary segment table entry is connected to the specified 
shared page table, the segment table entry indicated by the high-order 
halfword of register 1 is set not available; its auxiliary segment table 
entry is marked assigned and shared, and the shared page table number in 
register 1 is inserted into the auxiliary segment table entry. 

Froqrammina Mote : The ClSlG macro instruction is used by the privileged 
system to keep track of a task's shared page and segment tables, for 
example, a COVllCT request for virtual storage allocation (?HI) causes a 
C1SE6 macro instruction to be issued, fhe system programmer should use 
the COllECT entry point (CZCGI7) in fll to accomplish this function. 

Example : Suppose shared page table number 3 is to be connected to seg- 
ment 12. The macro instruction might be written: 

1J6 C1SE6 12,3 

This would generate (showing you how the number in register 1 is 
obtained) : 

IJG DS OH 

&I3 SETI 3*12*65536 
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SfC 238 

Shaired page table 3 is €:oiiiiec'ted to segment 12 and the higk-ozrder half- 
vord of register 1 is left anchanged (as 12) to indicate the actual seg- 
■ent to whiclL the shared page table vas connected* 

CRTS I — Create Task Statns Index fR) 

The CRTSI nacnro instrnction allocates storage for a TSI and initia- 
lizes it for a nev task if the systen liait on TSIs has not been 
reached. 

I 1 — -"• — ^ i 1 

I lane | Operation (Operand | 

I 1 1 1 

|[sfnbol]|CRTSI I I 

t t I I 

Bote s There are no operands. 

Initialization : I DCLISS aacro instr action with the FRI¥ILE61D option 
must be coded in a CSICT prior to coding CRTSI. If sore than one DCLASS 
■aero instruction is issued in a nodule, the last BCLASS issued prior to 
coding CRTSI nust be issued with the FRI7ILS6EI) option. 

Execution: I new task status index is created if the sj stem TSI Unit 
has not been reached. 

Return Bata ; The task identification of the new task is returned in 
register 0; if the sjstea TSI linit has been reached, register is set 
to 0. 

Bxanple ; If you want to create a TSI, you sight writer 

IIZ CRTSI 
This would generate: 

Xf2 SfC 253 
lote : This STC must be used in conjunction with FSBID. 

CSEG — Connect laned Seanent CO) 

The CSEG macro instruction transfers control to the connect naaed 
segnent progran in the resident supervisor. An attenpt will then be 
Bade to connect the specified disconnected segnent group. 



1 1 1 

Vane {Operation {Operand I 

1 1 ^ 1 

ICSEG I I 

I I : I 



Bote : There are no operands. 

Initialization : Before executing CSEG, the issuing progran should have 
set up the following parameter area: 

CHAKSG BSECT , COHHOl lAHESEG PARAMETER LIST 

Bs or 

HSGSfC DS H S¥C 

DS XL 2 RESERVED 

ISGRVA DS XLB RESERfEB SEGEEIT GROUP lAlE 
ISGBIA BS 118 BISCOllECTEB SEGHEET GROUP HAHE 



12«l 



ISGflJI 


m 


k 


BSGLIG 


DS 


H 


HSGfLI 


DS 


II.1 


1S6FLO 


DS 


XL1 


HS6DIG1 


IQU 


X*80» 


1S6BB0H 


IQO 


X»ftO« 


ISGID6B 


EQU 


I«20» 


1S6B1DH 


BQU 


X»10« 


ISGLHGB 


BQU 


X«08» 




DS 


P 


ISGLTH 


EQU 


*-CHI 



f IITUIL Sf OlIGB IDDIBSS OF SBG GEODf 

LBBGTH OP BIBBD GBOQF 

IBFDl FLIGS 
OUTFIT FI.IGS 
DBllB SFBCIFIBD 
BBJkBB SFBCIPXBD 
IDDIESS SFECIFIED 
lODB-BOITBD 
iBBGTl SFBCIFIBD 

IBSBlfBD 
LBIGTI OF FAIIHBTBI LIST 



CSBG Bust be the object of an execute instmctlon and be fullvord 
aligned. 

Bxectttlon ; Tbis iiacro instruction passes control to tbe resident super- 
visor Bodule CBIF5 via S¥C 183. An attenpt will tben be aade to re€:on- 
nect the specified disconnected segment group. 

FroaraBBinq Bote ; The sfstem programaer should use the COISBG Macro in- 
struction described in Asseabler User Bairro Instruction » GC28-200i>. 



CVT — Activate CoBBunications Vector Table 

The C?T Bacro sets a GLOBAl SBTB sfBbol CHDCfT used bf sfsteB Bacros 
to det^TBine if the user has furnished a base register for the syst^ 
CVT control block. The CVT nacnro also does a copf of the CVT dsecrt 
CHACIT if the user has not provided one. If the user has not provided a 
base register for the CVf (C¥T BO) , then the sjsteB Bacros use Register 
15. 



T -I 

I Op er atiom | Operand 



I Bane 

I 



I[sjBbol]|CVT 

I 1. 



I {IBS I BO) 

-I 



IBS I BO 

indicates whether or not the user has provided a "USIBG CHACVT>lx* 
stateBent assigning a base register for the C?T control block. 

Default : BO. 

CAOflOB : CVT sets the GLOBAI. SETB SfBbol CHDCVT. If CVT lES^ CHDCVT is 
set to a 1. 

FroaraBBina Botes ; The FSA dsect ClAFSA Bust be copied bf anf assenblj 
using any supervisor macros. Otherwise^ the Bacros will generate error 
statenents when assenbled. 

The pointer for the CVT control block is in the FSA and is sjBbolicallj 
addressed as FSACVT. 



ExaBPle ; 



USIBG CHAPS A, 10 
1 112, FSACVT 
QSIBG CHACVT,B12 
CVT IBS 



assign base register to FSA 

load address of CVT 

assign base register to CVT 

tells sfsteB base register is assigned 
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DCB IHSAMl — Set Up Data Contirol Block iO\ 

In explanation and tlie general format of the BCB macro instrnctlon is 
contained in Assembler User Hacnro Instructions , The operands available 
onlj to the TSS nser with privilege class E (sjstem monitor) for nse 
with HSIH are described below and supplement the operands descn^ribed in 
Assembler User Hacro Instrnctions , 

Ion can refer to the infornation stored in the data control block bf 
means of the BCBB macro instrnction, which is also described in Assem- 
bler User Macro Instrncrtions * 

Information regarding a data set maj be provided through the BDEF 
command and macro instmcrtion and bf fonr program itself (bf placing in- 
foraation in the data area created bf four BCB macro instruction) in ad- 
dition to the information fnmished at the time the BCB macro instruc- 
tion is issued. Figure 23 illustrates possible sources of information 
for various fields. 



1 — 

1 

1 


i 


"-" -i-" "■"— " -" ■ ■ ■"" " ■ ""■-" • - 

1 Alternate Sources 






- —I 


iDCB Fiel^ 


1 1 1 
ITour Program |BBEF Comnand and |BCB 


Macro 


[Tour Program] 


1 

t 




1 Prior to OPEl (Hacro Instruction | Instruction 
II ' 


f After OPEl | 


1 

IBS0B6 




1 1 1 


1 








IBACIF 




i X 1 


X 1 


X 






IDBIAHE 




i X 1 




X 






|BE¥B 




1 I 1 


X 1 


X 






IPlfSpi 




t I 1 


X 1 


X 




f X2 1 


1 lOBSai 




1 X 1 


X 1 


1 




1 X2 1 


ISIACK' 




1 X 1 


X 1 


X 




1 X2 1 


IIECFH 




1 X 1 


X 1 


X 




1 X2 1 


tLlBCL 




i X 1 


X 1 


X 




1 x^ 1 


f POCKET 




1 X r 




X 




1 X2 I 


IIBTBI 




1 X t 




X 




1 X2 1 


ISBB 












1 xs 1 


IINBHSG 




1 X 1 


X 1 


X 




1 X 1 


lEIF 












[ x^ 1 


ICOIBIIE 




1 X 1 




X 






IFOIMTTFE 

1 




1 X 1 


f 


X 




1 x^ 1 

1 1 


1 ^Checked 
1 


on 


If if BBVB speriLfies 


a printer (PI) . 








i 

1 2Checked 


on 


I If if a FIIISH macro 


instruction has been 


exea 


Eited and a i 


1 return code other than 4 was provided, and if no 


GET 


or ] 


POT nacrro in-| 


1 strucrtion 

1 


has been executed after the FIIISH. 








1 

1 ^Checked 


on 


I If if BEVB specrLfies 


a card punch (PQ 


or 


a €m: 


rd reader | 


1 (IB). 
1 














1 

|*For format-F records, footnote 

1 


2 applies. 








i 

|50nlf if 


a 


SETim macro instruction has been executed 


and j 


% return code! 


1 of 4 was provided. 
1 










|*Onlf if 


a 


FIIISH macro instruction has been executed 


and 


a return | 


1 code of 


4 


was provided. 











Figure 23. Sources of BCB information for MSAM 

The data irontrol bloidc (BCB) for MSAM includes five fields (HETIX, 
COMBIIE, POCKET, FOHHTfP, and IMHHSS) that are not reguired in the BCBs 
for the other access aethods. These fields, as well as others pertinent 
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to the access aetliod, aaf be filled osing tlie BCB aacro Instmction , as 
follows: 



-1 1 ^ " 1 

I Op eratlon | Operand I 

■4 ^ 1 

|DCB |DS01G=IS[ ^11C1F={S|P) ]t ^DDll!!l=lia»e ] | 

|[ ,DBVD=codeI ^llCfH==code][ ,I.lECn.=record length] | 

I[ ^Elfl¥=pHI) ][ ,C01BI1E-£Y|1) I ,P0CKET={1 12 |OES} ] | 
|[ ^F01HTIP={F|S|D} ir^IlHlSG^Clll} ] | 

I I, ^ . ^ 1 

Mote : If the IJLClFr I>BlJLHBr DBVD, llCFl^ IMECL, EET'BLl , WQCKET, and FOl- 
HI^IP operands are not specified, the information anst he famished bf 
another source described in Figure 23. 

DSORG= 

specifies the organization of the data set. 

Specified as s For HSIM, the only acceptable code is IS. 

1IC1F= 

specifies the tfpe of nacxo instructions to be used in processing 
the data set. 

Specified as : For HSAH, only the options 6 and P (for the GET and 
PUf nacro instrnctions) are permitted. 

specifies the sjnbolic data definition name associated vith the 
data set. 

Specified as : 1 nane of three to eight alphameric characters. 
This name mnst be the same as the ddname of the BDEF command or 
macro instruction associated vith this data i^ontrol block. Each 
data set to be processed regnires one BCB macro instruction and one 
DBEF €3ommand or macro instrncrtion . 

DB¥B= 

specifies the type of device on which the data set resides. 

Specified as ; The three options available for ISIl are PC, PR, and 
ID (for the card punch, printer, and card reader) . Iddltional key- 
word operands are available, as shown below, to provide devi€:e- 
dependent information to the device-dependent parameter bytes in 
the data c»>ntrol blodlL. 

Idditional Keyword Operands 
[,10I>B=£C|E) ] C,STlCK=^fl|2|3| ] 

[ ,P1TSP={0|1|2|3} ] 

C,10DE=fCfB) 3 [,STIC1={1|2} 1 

10DE= 

specifies the mode of operation for a card pnnch or card reader. 

Specified as : For HSAH, the available options are: C (c^olnmn 
binary mode) or E (EBCDIC mode) . The value of the MODE field may 
not be altered after the BCB is opened except between a completed 
FIIISH and the next GET or PUT macro instruction. 
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Code 
PC 


leanina 
Card pnnch 


PR 


Printer 


RD 


Card reader 



Default g 1 

STIC![= 

specifies whicli stacker bin is to receive the record. 

Specified as ; 1^ 2, or 3. Stacker bin 3 laj be specified oiilf if 
tke pirnck (PC) is specified. The STICl field is ignored if I or 1 
is specified in BICFH at OPBH tiae. 

Default ; 1 

PEfSF= 

specifies the nuaber of line spaces after printing. The field will 
be ignored if 1 or 1 is specified in the DCB BBCFH field. 

Specified as s 0, f^ 2^ or 3. 

Default ; 1 

11CFM= 

specifies the characteristics of the records in the data set. 

Specified as ; Inj of the following order are valid; 
{f |?}[B ][1|1]. B^ however, will be ignored. Iny other record for- 
mat designations will abnoraallj terainate the task. 

Control Characters 1|1: Is an optional feature, records aay 
include a control character in each logical re<:ord. This cjon- 
trol character will be recognized and processed if a data set is 
being written to a printer or punch bf HSIH. This character is 
provided bf the user as the first byte of the logical record. 
Two options are available: 

• fOlTlII* Code (!) - The user aaf choose to specify this code 
rather than the aachine code. The control byte anst appear 
in each logical record if this option is chosen. 

• Machine Code (H) - The user aay specrify in the data <rontrol 
block that the aachine code control character has been 
placed in each logical record. The byte supplied by the 
user anst contain the bit configuration specifying a write 
and the desired carriage or stacker select operation. (This 
peraits independent carriage and stacker select operations.) 

L1BCL= 

specifiLes the record length or, for foraat-?, the aaxiana record 
length. 

Specified as s For foraat-F records, the length in bytes. This 
length anst include the control character for an output data set if 
(IIH) is specified in lECFH. The length aay not exceed 80 bytes 
for reading in EBCDIC aode and 160 bytes for coluan binary aode. 
For an output data set on a printer, the aaxiaua is 133 bytes; and 
on a card punch, 81 bytes for EBCDIC and 161 bytes for coluan 
binary (the additional byte for output data sets is for the control 
byte only if 1 or H is specified in the ISCFH) . 

For foraat-? records, the aaxiaua length in bytes of a logical rec- 
ord. LBSCI. aay be aodified after the DCB is opened at any tiae. 
The length can not exceed 84 bytes for reading in EBCDIC aode and 

♦Foraerly era lied ISA or extended USASI code, this code contains control 
characrters defined by Aaerican lational Standard FOBTIAW, AWSI X3.9- 
1966, hereinafter referred to as FOBTRAW control characters. 
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164 bjtes for colmn bimarj aoie for an l&put iata set. For an 
output data set on a printer, tke nailmiin is 137 bftas; and on a 
card pnncli, 85 bftes for SBCBIC and 165 bjtes for colnnn binarj • 
the additional bf te for ontpnt data sets is for tbe control by^ 
onlj if 1 or ■ is specified in tbe llCFl* Tbe four or five control 
bytes of a format -▼ logical recrord are not pnncbed or printed. A 
fornat-? logical record vill have five control bytes wben a FOITRII 
control character is specified. 

specifies the error retry for the 25%0 (reader only) . 

Specified as : the available options are ■ or U, where V indicates 
»no retry and II indicates nnliaited retry. 

Default ; U 

C0IBI11= 

specifies that a card is to be read in vhen FIllSR is issued during 
a FQICH job, effectively separating different punch Jobs. Each 
tiae a FIIISH or CLOSE aacro instruction is issued, a card is read 
from the reader and stacked in pocket 3. 

Specified as: I or 1 

Default : 1 

Bote : The SMCl option chosen for the punch must be 3 if COIBIIB 
is Is otherwise, the task vill be abnonally terminated. 

FOCKET« 

specifies error card stacker bin (for the card reader on the 2510 
only) . 

Specified as : The available options are OlCr, 1, and 2, where OIG 
means stack as if no error occurred, 1 means stacker bin 1, and 2 
means stacker bin 2. 

Default : 1 

F01ITyP= 

specifies how printer error retry is to be performed. 

Specified as : D, F, and S. The meaning of these codes is describ- 
ed below. 

D (storage dump type) : Ittempt write retry (no skip or space) 
three times before the DECB is set complete with error. If one 
of three retries is suc:cessful, use the strike-out character (I) 
to strike out all print positions and reprint the line. If 
three lines on one page have been struck out, eject to channel 1 
and continue. 

F (form-sensitive type) : Ittempt write retry (no skip or space) 
three times before the DECB is set complete with error. If one 
of the retries is successful, eject to channel 1, tell the oper- 
ator to mark the error page, wait for acknowledgement, and then 
rewrite the entire page. The page is rewritten starting trom 
the previous skip to channel 1. Bote ; FOBTBIB (ASl) or machine 
control characters must be used with F-type forms. 

S (seguence-sensitive type) : Ittempt write retry (no skip or 
space) three times before the DECB is set complete with error. 
If one of the retries is successful, tell the operator to mark 
error page, wait for acknowledgement, and then continue with the 
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saae output page, notes FOITIAV (ASA) or aacliiiie control 
characters Bust be used vlth S-tjpe forss. 

Default s D 

I1HISG= 

specifies whether or not nessages to the operator to reaoTe the 
data group when a CLOSE or FIVXSH nacro instruction is issued are 
to be suppressed. 

Specified as s 1 (yes) or 1 (no J 

If the I option is chosen and CI>0S1 or FIIISH is issued, a nessage 
is sent to the operator to reiioTe the data group froB the de^ic^. 
then the operation indicated by the WfO is complete, the operator 
is soae instan<:es will be requested to generate an asynchronous in- 
terruption by changing the status of the device fron not ready to 
ready. This bit, DCB19HHS, nay be dynanically modified by use of 
the BCBB nacro instruction. 

Defaults II 



DCLASS — Specify Privilege Class 101 

The DCLASS nacro instruction declares the user's intent to assemble 
privileged or nonprivileged code by setting the global SETS symbol, 
SCHDCLS, to 1 (privileged) or (nonprivileged) . Unli)ce other nacro in- 
structions, DCLASS is used only during assembly. It directs nacro 
definitions that check the synbol SCHDCLS to generate privileged or non- 
privileged code. 



I 1 I 

I Sane | Op er ation | Opera nd 

I 1 1- 



I [ sy nbol } | DCLASS | [ privilege class ] 



privilege class 

specifies whether the code following this na<:ro instrucrtion is to 
be assembled as privileged or nonprivileged. 

Specified as s PIIVILIGED (privileged code) or USEE (nonprivileged 
code) . 

Defaults DSEl. If no DCLASS is issued it is assuned the code is 
nonprivileged • 

CAOTIOW s Before issuing a nacro instruction whose corresponding aacn^o 
definition refers to the &CHDCLS global synbol, a user must be sure the 
synbol is set properly. The required settings for the various TSS nacro 
instrucrtions that use this mechanism are indicated with their descrip- 
tions. DCLASS settings required to issue macro -generated SVC instruc- 
tions are shown in Appendix B. 



DfLET — Enter Delete Program (01 

The DELST macro instruction causes control to pass to the dynamic 
loader's Delete routine via the task monitor. 

130 



IHase lOperationfOperand I 

I 1 4 ^ ^ ^ ^ -^ 

r[sj»bol]IDBI.11? I I 

I 1 1 ^ ^ ^ — ^ . . 1 

lots: There are no operands* 

Execution ; k task-S¥C interruption is created to transfer control to 
the task Monitor. Control is then transferred to the dynamic loader^s 
Delete routine. (See Isseabler Pser Macro Instrnctions for a descrip- 
tion of the DlLETl Bacro instruction.) 

Bxaaple : If yon want fonr program to enter the Delete program within 
the dynamic loader i yon would not use the EMfBB mechanism; yon conld 
write : 



IIHB 



El 


OrlIMB 


B 


AlAI 


BELE1? 




DC 


CL8«DEST1YHE» 


DC 


X»OOOD» 



DBlBf would expand as: 

IAMB SVC 123 



DBI,pg — Delete Virtual Storage Pages (II 

The DBLPG macro instruction is used by the system to delete conti- 
guous pages from a task's virtual storage and^ when possible, to delete 
the associated page table entries. 



I ^ • -T * 

I lame | Operation | Operand 

I ^ ^^- 



|[symbol]|DBLPG |[page count} [, first page address] 

I 1 . t. 



page count 

specifies the number of contiguous virtual atorage pages to be 
deleted. 

Specified as : an absolute expression or register notation. 

Default: If the operand is omitted, it is assumed that the page 
count has been placed in register ©• 

first page address 

specifies the address of the first virtual storage page to be 
deleted. 

Specified as ; an IX address or register notation. 

Default ; If the operand is omitted, it is assumed that the first 
page address has been placed in register 1. 

Initialization : k DCI.ASS macro instrucrtion with the PEIVII.BGBD option 
must be coded in a CSECT prior to coding DEI.PG. If more than one DCLISS 
macro instruction Is issued in a module, the last DCLISS issued prior to 
coding DELPS must be issued with the PIIVILBGBD option. Before the 
DELP6 macro instruction is executed, the issuing program must set up the 
first byte of register 15 with one of the following codes: 
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Code Heaning 
00 user requested delete 
02 sfstea requested delete 

Ixecgtion: The comtigiioiis pages, beginiiiiig at the address contained in 
register 1 and equal to tlie count in register 0, are deleted froB tlie 
issuing task's virtual storage. Hain storage and paging storage space 
in use for tke released pages are freed for reallocation « If an entire 
segment is deleted, the auxiliary segment table entrf is narked unas- 
signed, the segnent table entry is narked not available, and an indica- 
tor is set to represent the deleted segment. The space occupied by the 
page table entries and external page table entries is returned for real- 
location. Xf the auxiliary segment table entry is marked shared, the 
entry corresponding to the segment in the resident shared page index is 
deleted. 

Programming Wotes : The DILPS macro instruction is issued by the privi- 
leged system to keep track of a task's page, segment, and shared page 
tables. For example, a FllBllIH request for virtual memory allocation 
(VHA) causes a !>E1P6 macnro instruction to be issued. The system pro- 
grammer should use the FllBlim macro instruction to accomplish this 
function • 

The DllPG macxo instruction can be used for deleting both unshared and 
shared pages. 

Example s Suppose three pages of virtual storage originally allocated by 
a system program, starting at IBCIIZ, are to be deleted. The macro in- 
struction might be written: 



LA 0,3 PIGl COUIT 

LI 1,IBCXYZ PIIST PIGB IDBIBSS 

LA 15,X«02» STSTEH IBQUBSTBD DBLBTB 

SLL 15,24 * 

DBLPG 



PBQGQB — Pegueue 6QB from SCAB Table 

D6QGQB sets up the parameter list and calls CBIJDB to dequeue a GQB 
from the SCAN table. 



I lame | Operation | Operand 

I 1 h 



t[ symbol IIBBQGQE |6QB 



6QB 

address of the GQB to be dequeued. 

Specified as s the name of a symbol defined as a fullword, or 
legister 2 through 12 or 1. 

CAPTIOBS 2 The PSl dsect CHIPS! must have been copied and assigned a 
base prior to the use of this macro. The expansion of this macro is 
affected by use of the CVT macro prior to the use of this macro. 
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Eicamples ; 

CI) Register notations CfT ¥BS is assnned 

DBQGQl (1) 
* BILl in, 15 

(2) SfBbolic name; C^n ¥1S is assmaed 

BEQGQE 7C1GQ1 vkere TC16QS is defined as a fullword 

♦ CHBVIL TCWGCIB^I 

♦ Is l^fClGQI 

♦ L 15, CTOJBB 

♦ BILE 1«l,15 

(3) Sf Bbolic nane; CfT 10 is assnned 

DEQGQE fClGQB vhere fCWGQB is defined as a fnllvord 



♦ CHBTII, TCIGQE^I 

♦ L ItfCWGQE 

♦ I. 15,PSICf!C 

♦ I, 15,CVTJB1-C1ICV1?(,15) 

♦ BILE 14,15 



PISIBLE ~ Disable System Intenrnnts 

DIS1BI.E pernits tlie user to "disable"* sfsten interrupts and address 
translation. It sets a nev systen nask, and if desired bf tbe nser, 
saves tlie previoiis sjsten Bask in a specified area* 

I f ""1 "^ 1 

I Bane | Operatiom {Operand I 

I 1 -I ^ 1 

I [sjnbol]! DISABLE |[1SBI=] [^10=] CBXf^] C r^2^*l [ rTlII^J | 

I 1 -J ^ 1 

IBEA 

area in vkich the current sfsten mask is to be stored 

Specified as ; an EX address or register notation 

Default ; Current systen nask is stored in a field in tbe PSA*PSASH 

10= 

I/O interrnpts 

SpeiAfied as ; 

¥ - disable I/O interrnpts* 

I - status of I/O interrnpts is nnckanged. 

Default ; f • 

EXT= 

external interrupts. 
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Specified as : 

f - disable external interrupts • 

II - status of external interrupts is unchanged. 

Default : Y. 

Prograa Event Recording Interrupts. 

Specified as : 

Y - disable progran event recording interrupts. 

M - status of program event recording interrupts is unchanged. 

Default ; Y. 

address translation - 

Specified as : 

Y - disable address translation * 

1 - status of address translation is unchanged. 

Default : Y. 

Executio n; DISABLE uses the S/370 instruction STISM. 

Return Data : AREA, if defined, contains the previous system mask after 
execution of the DISABLE. 

Examples : fo disable onlf I/O interrupts, fou may write: 

DISABLE I0=Y,EXT=N,PER=M,1'RAM=N 

To disable all interrupts and later restore the system mask to its pre- 
vious configuration, you may write: 

DISABLE AREA=AREA disable all interrupts and 

save current system mask 
SSE SAVE restore old system mask 

I SAVE DC X»00« area to save system mask 

I DISCSEG — Disconnect Segment Group COI 

I fhis macro instruction is completely documented in the Assembler User 

I Macro Instruction manual, except for one operand that is available only 

I to a systems programmer. The definition and specification for only that 

I one operand are given below, but for continuity, the metalanguage format 

I that follows shows all the operands. 

I L-form 

• ^ • 1 ^ ^ 1 

I IHame | Operation I Operand I 

I 1__ 1 1 

f ISymbol IDISCSEG |[DHAHE=,LBIIG1?H=,B00HD=,RIIAM1=,KBLEAS=, J HF=L | 

I ^ 1 ^ 1. 1 

I B-form 

I 1 — ^ 1 ' 1 

I tNa&e I Operation (Operand I 

I 1 1 ^ , 

I |[ symbol ]|DISCSEG |[ DMAlE=,LEMGfH=,BOCilD=,l"ilAliE=,ADDRESS=,lELEAS=, ] \ 

I I I |MF=(E,LIST) I 

I ^ I 1 _J 
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standard -Fora 



I i T' 

I Ha&e I Operation | Operand 



|[syabol ]|DISCS1G f[DMAME=,Ll»GTH=,BOUMD=,RllMS=^II>DRlSS=,lBLE^S=, ] | 

I, i I-. ^ . 1 

Mote: all operands are kejuord. 

RILIIS- 

specifies whether the reserved segment GBTIAII option is enforced 
while the named segment is disconnected from the task's address 
space (Refer to the GlTKIIl and RSf SEG macros) . 

Specified as ; 

I - the reserved segment GETMAIN option is not enforced. 

M - the reserved segment GETMIIM option remains in force. 

Default : 1 

Mot e: this option is available to privileged class modules only. 

DLIiK — Transfer to Dynamic Loader for External Symbol Besolntion (01 

The DLIHK macro instruction provides external symbol resolution 
(explicit loading) and may also provide transfer of control to a program 
(explicit linking) . 

I ' — I r ^ ^ ^ 1 

fName | Operation! Operand | 

I 1 1 ^ ^ 1 

|[ symbol ]|DLINK I | 

i 1 1- ^ ^ _ ^ I 

Mote : There are no operands. 

Execntio n: The resident supervisor creates a task~SVC interruption to 
transfer control to the task monitor. Control is transferred to the 
dynamic loader's DLIIK (dynamic linkage) routine. DLIHK can be used for 
explicit linking (external symbol resolution and transfer of control to 
loaded program) or explicit loading (no transfer of control) . DLIIK 
must be the subject of an execute instruction. (Ilso see CALL, LOAD, 
ARM, and ADCOH in Assembler User Kacro Instructions .! 
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B 


11 &T 




DS 


OP 




DLIVK 






DC 


I»0100» 


OPTIOIS : 


DC 


CL8»BEGIW» 




DC 


2F»0« 





BraMPle ; Suppose fom want to drnasicallf load a program called H1I.F and 
kave control transferred to its entrf point, B16I1. fon nlglit vrite: 

IsOm 11 ABCIGIP 

1BC1I6BP 

DLIIK 

LOIB IIB fimSFlB 



This canses tlie dfnanic Icmder to recseive control fron the task monitor 
▼ia the supervisor; it will then load H1I.P and transfer to BBGIl. 

PLTSI — Delete lasli Statns Index fQI 

the HLfSX macro instruction deletes the specified f SI and removes its 
associated task from the sfstem. 



i I ~-i ^ 1 

flame | Operation fOperand I 

I 1 H ^ 1 

i[S7mhol]|BLTSI t I 

■, ■■ ■ -j; ^ 1 

lote ; There are no operands* 

Initiali zation s 1 DCLISS macrro instmcition vith the P1ITII.E6BII option 
must be coded in a CSBCT prior to coding DI»TSI» If more than one DCI.1SS 
macro instrncrtion is issued in a module, the last DCI.1.SS issued prior to 
coding BLTSI mnst he issued mith the P1IVII»B6B1> option. 

Ixecntion ; The task issuing the S¥C is eliminated from the system* All 
nonshared pages of main storage and paging storage nsmd by the task are 
returned for reallocaition • 111 storage reguired for table entries per* 
taining to the task in the resident supervisor is released. 

Bxamnle ; To release all the resources a task is using — logically eli- 
minating the task — this might be vritten: 

BJG BI.TSI 

yote ; This SfC is the last step in a segu^ice reguired for removing a 
task. Other steps include closing data sets and releasing external 
storage and devices. 

PSBG ~ Disconnect lamed Segment fOl 

The BSBG macrro instruction transfers c»>ntrol to the disconnect named 
segment program in the resident supervisor. In attempt will then be 
made to name and disconnect the specified segment group. 

i 1 ^"ni • 1 

I lame (Operation (Operand I 

I , ^ 1 

I insiG f I 

I i . t ^ J 

Bote ; There are so operands. 

Initialization i Before executing DSBG, the issuing program should have 
set up the following parameter area: 

CHAISG BSBCT , COHBOl IIBBSBG PIBIHBTBI LIST 
DS Of 
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ISGSfC 


DS 


H 




DS 


112 


MSGBII 


DS 


XLS 


ISGDlfl 


DS 


1L8 


WSG¥H1 


BS 


I 


1S6L16 


DS 


1 


ISGPLI 


DS 


XL1 


ISGFLO 


DS 


XL1 


ISGDIGH 


IQU 


X»80« 


MSGRIGH 


IQU 


X»ilO» 


ISGADGH 


EQU 


X»20» 


HSGBIDH 


IQO 


X»10» 


ISGLiGH 


EQ0 


X"08» 




DS 


F 


ISGI.TH 


EQO 


♦-CM 



SfC 
RBSBSTBD 

EBSlRfSD SBGBBWf GIOUP BIHB 
DISCOIHBCI^BD SBGHBV7 GROUP VIMB 

FIRTUAL STORIGB IDDRBSS Of SBG GROUP 

LBRGTH OF lAHBD GROUP 

IIPUT FLAGS 
OUTPUT FLIGS 
DIAHB SPBCXFIBD 
RHIE SPECIFIED 
ADDRESS SPECIFIED 
HODB=*^BOUBD 
LEIGTH SPECIFIED 

RESERVED 
LEIGTH OF PIRllETBR LIST 



DSEG Bust be the object of an execute instruction and be fnllword 
aligned. 

Execution: This aacTro instrucrtion passes control to the resident super- 
visor module CEAP4 via STC 182. In attempt will then be made to nase 
and disconnect the specified segment group. 

Programming Bote ; The sjstem programmer should use the DISCSBG macro 
instruction described in Assembler User Bacro Instrucrtion # GC28-2004. 



DSSEG — Disconnect Shared Page Table From Segment IR) 

The DSSEG macro instruction disconnects a segment table entry from a 
shared page table. 



I Bame I Operation | Operand 

I f ^ --I 



|[sfmbol]|DSSEG 

I I 



I 



Bote : There are no operands; see Initialization. 

Initialization : The DCLASS macro instruction with the PRIFILEGBD option 
must be coded in a CSECT prior to coding DSSEG. If more than one DCLASS 
macro instruction is issued in a module, the last DCLASS issued prior to 
coding DSSEG must be issued with the PRIVILEGED option. 
Register must contain a known shared page table number right adjusted 
in the register. Register 1 must contain a relative page number (left 
half) and page €:ount C^ight half) that describes a range of addresses 
contained in the shared segment group. 

Execution : The address space defined bf the input parameters is discon- 
nected from the requesting task's virtual storage. If this results in 
an entire segment or group of segments being free, the segments are dis- 
connected and the virtual storage is made unassigned. 

Programming Bote ; The DSSEG macro instruction is used bf the privileged 
system to keep track of a task's shared page and segment tables. For 
example, a disconnecrt request for virtual storage (¥BA) causes a DSSEG 
macro instruction to be issued. The system programmer should use the 
disconnect entry point (CZCGA8) in VBA to acscomplish this funcrtion. 
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Bxaaple : Suppose two pages of shared page table miaber X»FF10* starting 
at relative page number 3 are 1^ be disconnected froa a task^s virtual 
storage- The code might be written 

LI R0,11irSPTPC 
km DSSIG 



SPTPC BC 1 {X«0000FF10«) ,1 (X00030002") 



I DOPCLQSE — Close a Duplexed Data Set fSI 

Mote: this macro anst not be used for new code. It is docu- 
mented here only to aid in the Maintenance of existing 
programs* 

The DUPCLOSE macro instruction disconnects the primary and secondary 
data sets of a duplex data set from the user^s problem program and 
removes the duplexing linkage between such data sets. 



I 1 ^1 

I N ame | Opera tion | Operand 



I [symbol II DUFCLOSl |dcb address l^dcb address 2[ ,«F = p| (l#list) ) ] 

1 1 . . . 



Mote ; k symbol is required in the name field of the L-form. If the MF 
operand is omitted # the standard form is assumed. 

deb address 1 

specifies the address of the data control block opened for the pri- 
mary data set that is to be permanently disconnected (closed) from 
the system and removed from duplex data set mode. 

Specified as : In the standard and L-form^ as a relocatable expres- 
sion; in the standard and 1-form^ in register notation (2 through 
12J ; in the 1-form only, as an explicit or implied address. 

deb address 2 

specifies the address of the data control block opened for the 
secondary data set that is to be permanently disconnected (closed) 
from the system and removed from duplex data set mode. 

Specified as ; In the standard and L-form, as a relocatable expres- 
sion; in the standard and E-form, in register notation (2 through 
12) ; in the E-form only^ as an explicit or implied address. 

Initiali zation ; If this macro instruction is to be executed in a privi- 
leged module^ the most recently issued DCLISS macro instruction in the 
assembly must have specified PSIVILEGED (see Appendix H) . Also, the 
address of a save area must be placed in register 13 before this macro 
instruction is executed. 

I CAUf lOM : fhe following errors cause the results indicated: 
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^ . — ^ — ^ . . . ^ 1 

Error f IctioE 

^ ^ ^ . 1 

Pemaaently closing a duplex lata set whose data |lo action 

control blocks aute alreadf closed I 

+ 



I deb address operand aoes not specify the |fask terminated 
address of a data control block | 



DSOIG specification is invalid ITask terminated 

- — ^ . ^ ^ ^ — - — . ^ 1 



Frogr ana incf iotes : The BOPCLOSE »acro instruction generates code which 

places a pointer to a parameter list in register 1. 



I ^ — -""^ — ^ 1 r ^ • ^ ^ — I 

I Begister 1 | — ^ — ^Pointer to DCB 1 I Word 

•— ^ ^ ^ _J I ^ ^ _ • 1 

I Pointer to DCB 2 fiord 1 

I ^ ^ I 

fhe DOPCIOSE Macro instruction releases any sharing interlocks set 

for either the priaary or secondary data set. 

Eitanples : See the examples under the description of the BUPOPEM macro 

instruction • 

DOPOPSl — Open Duplex Data Set (SI 

Mote : this macro must not be used for new code. It is docu-- 
men ted here only to aid in the maintenance of existing 

programs. 

fhe DPPOPBM macro instruction links a primary and secondary data set 
together so that all changes to the primary data set are immediately 

reflected in the secondary data set. Thus^ at any instant, the two data 
sets are exact copies of one another. DUPOPBN is used only with ?AM 

data sets. 

I — - — -T---------- — 1 ^ — ^ ^ ^ 1 

Ilame | Operation | Operand I 

k — ^ ^ f ^ — f ^ ^ ^ 1 

|[ symbol 31 DOPOPEH |dcb address l^dcb address 2[ ^option ] I 

I I |[,EF={E| {Li^listn ] I 

i — lu-. - L- ^ . ^ ^ 1 

lote ; k symbol is required in the name field of the L-form. If the HP 

operand is omitted, the standard form is assumed. 

deb address 1 

is the address of the data control block corresponding to the pri- 
mary data set. 

Specified as : In the standard and L-form, as a relocatable expres- 
sion; in the standard and E"-form, in register notation (2 through 

12) ; in the E-form only, as an explicit or implied address. 

deb address 2 

is the address of the data control block corresponding to the 

secondary data set. 

Specified as : In the standard and L-form, as a relocatable expres- 
sion; in the standard and B-fom, in register notation (2 through 
12) ; in the E-form only^ as an explicit or implied address. 
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option 

specifies the intended ttethod of inpiit/otitpiit processing of tke 
data set being connected to the system. 

Specified as ; the various processing options and tkeir meanings 
are : 

r ' "1 ' ^ ^ " ' ~ 

IC^de {leaning 



I 1 ^^ ^ ^ ^ ^ ^ . 

I II POT [The data set can be used as input only. 
I h 



f OUTPUT |The data set can be used for output or input, 
I h 



flMOUT fBotk input and output operations are allowed. The BCB is 
I I opened as IIPIJT. 
I 1. 



JOPTII iiiotk output and input operations are allowed* The DCB is 
I I opened as OUTPIiT. 
I 1 



{UP DAT I The data set can be updated* 

I 1 . ^ ^ 



Bot e: Opening a fXSIil data set for IWOUT or OUTIM is equivalent to 
opening for UFMT. When a data set is opened for UPDIT, however, 

the user Bust position to the desired record in the data set* 

Default : liPOf 

Initiali zation : If this macro instruction is to be executed in a privi- 
leged Bodule, the nost recently issued DCIISS aacro instruction in the 
assenbly Bust have specified PIIVILIGED fsee Appendix 1) . Ilso, the 
address of a save area must be placed in register 13 before this macro 
instruction is executed. 

CAUTIQli : If either copy of a duplexed data set is changed independently 
of the other, duplexing is invalidated in a manner that is transparent 
to the duplexing Bechanism and may cause false recoveries. 

ProaraaBinq lotes : DUPOPEl should be used judiciously. The external 
storage required to contain a duplexed data set is exactly doubled and 

the time required for data output is approximately doubled. 

The data set properties or attributes specified in each of the data 
control blocks and their corressponding DDEF statements must be identic- 
al* Similarly, any sharing properties specified by PllilT commands for 
each copy of a duplexed data set must be consistent. 

In event of an input error on a primary data set page, the corre- 
sponding page of the secondary data set is obtained and written back 
into the primary data set. This not only recovers the error but tends 
to keep the primary copy in an error-free state. 

Bach copy of the duplexed data set is placed on a separate physical 
volume, if possible, thereby further assuring successful error recovery. 

The DUPOPll macro instruction generates the following parameter list: 



I 1 I " — ^ — ^ ^ — 1 

llegister 1|— | Pointer to DCB 1 I 

«— 1 I . ^ ^ ■ ^ — 1 

I Pointer to DCB 2 I 

I ^ ^ 1 

t Pointer to option {using same translation as OPll) | 
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It then generates code whicli places a pointer to that parameter list 
in register 1^ and links to the DOPOPEH routine via a standard linkage. 

Exaaples ; In BX1 the data set defined by DCB naaed KJkSTlR is opened as 
the primary data set of a duplex data set and the data set described by 
the DCB named COPY is opened as the secondary data set. Both data sets 
are opened for IMOOT processing- In EX2^ the same two data sets are 
re-opened^ following disconnection caused by BUPCLOSl, for default 
CINP01?) processing. 

EISTD&1!I,fS^DSllIME=l!ISTFILE 

C0PrDA1*A^¥S,.DSHIMB=D!JPLICAT 

DDHAMB=MAS'FDITA^DSORG=VS,B1CFH=P^LRECL=80 

DDlfIlE=COFYDATI,I>SORG=VS^lECFl=F^LRECL=80 

MASTER ,CqpT,INOUT 

MASTER, COPY 

EASTER, copy 

MASTER, copy 

(MISTER, (IHPOT> ) Subsequent processing after this 

instruction would invalidate 
previous duplexed data set* 



EMABLE — Enable System Interrupts 

ENABLE permits the user to ••enable" system interrupts and address 
translation. It sets a new system mask, and if desired by the user, 
saves the previous system mask in a specified area. 



DDEFIHl 


DDEF 


I>I>BFIM2 


DDEF 


MASTER 


DCB 


COPY 


DCB 


EX1 


DlJPOPEir 




DBPCLOSE 


112 


DUPOPEN 




DOPCLOSE 




OPEN 



I ^ — I 1 

I Name | Opera tionj Operand 

I- 



|[ symbol ]|BNABLE |[AREA=] [,I0=] [,BXT=] [,PE1=] [,TRAM=3 

I ^ I 1 



AREA 



10= 



EXT= 



PER= 



area in which the current system mask is to be stored 

Specified as : an RX address or register notation 

D efault ; Current system mask is stored in a field in the PSA-PSASM 

I/O interrupts 

Specified as : 

Y - enable I/O interrupts. 

N - status of I/O interrupts is unchanged. 

Default : Y. 

external interrupts. 

Specified as : 

Y - enable external interrupts. 

M - status of external interrupts is unchanged. 

Defaul t: Y. 

Program Event Recording Interrupts. 
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Spacifiet as ; 

I - enable program eveat recording iaterrtipts. 

I - status of progran event recording interrupts is nnckanged. 

Default : I* 

address translation* 

Specified as : 

I - enable address translation* 

H - status of address translation is unchanged. 

Default : !• 

Exectttio n: ElIBLE asBS the S/370 instruction STISI. 

Return Data ; kEEk, if defined^ contains the previous system mask after 
execution of the IIIBLE. 

Examples : To enable onlf I/O interrupts ^ fou may write: 

DISABLE ABBA=A1EA 

ENABLE IO=f rEIT=I 

The DISABLE is done first to insure the rest of the interrupt types are 
disabled and to save the current system mask. The ElABLE is done to en- 
able only I/O interrupts. To restore the previous system mask, you 
could write; 

SSM SAVE 

SA¥1 DC X«00« 



EMQGQE — Encruene GQE from SCAl Table 

EHQGQE sets up the parameter list and calls CEAJEM to engueue a GQE 
from the SCAS table. 



I 1 T ^ 

I lame I Operation (Operand 

I , ^ 

I [ symbol ] | EilQGQE | GQE 

I 1 J 



GQE 

address of the GQl to be enqueued. 

Specified as : the name of a symbol defined as a fullword^ or 
Register 2 through 12 or 1. 

CAJJTIOKS: The PSA dsect ClfAPSA must have been copied and assigned a 
base prior to the use of this macro. The expansion of this macro is 
affected by use of the CVT macro prior to the use of this macro. 

Examples : 

(1J legister notcition; C¥T IBS is assumed 
EHQGQE (1) 

♦ L 15,C¥TJEH 

* BALK 14,15 
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(2) Synbollc aame; CfT IIS is assumed 

BHQGQE fCWGQl where TCWQQE is defined as a fuUword 

-I- CHDflL TCWGQl^l 

♦ I. l^fCWGQl 

♦ BILl W,15 

(3) Symbolic name; CVT MO is assumed 

BlIQGQl TCWGQE where TCWGQE is defined as a fullword 
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♦ I. IS^FSICfT 

♦ L 15yCTWll-CIlCVt|,15) 



EWfEB — gnt^er Privileged Smirwlcm Bootiae IB! 



I 1 ' — I 

I Maae lOperaticm fOperamd 

I 1 ^—1 

IfsfBbolllSlTlB I 

I i . I 



lote : There are mo operands. See Initializatiom. 

Initialization t Eegister 15 nnst o>ntain the enter c^de associated vith 
the privileged nodule being entered bf the nonprivileged progran execnt- 
ing the EITSB nacro instrmcrtion* Enter codes are snnnarized in Ippendiz 
I. 

Execution : k tas*-S¥C interruption is created to transfer c^ontrol to 
the task monitor. The Enter routine (part of the task monitor) trans* 
fers control to the indicated privileged progran, using modified tjpe-l 
linkage. Begister 15 contains a code, the enter code, that is used by 
the Enter routine to deternine which privileged progran is to receive 
control. Onlf the contents of registers and 1 are passed to the pri-* 
vileged progran; registers 0, 1, and 15 are the onlf registers the pri- 
vileged progran can use to pass results back to the progran issuing the 
EVTBB. Begisters 2 through 14 are saved and restored b; the enter rou- 
tine for the progran that issued BITBB. 

Example ; Suppose fou vant to get 25i bftes of working storage (without 
using the GET! I II nacro instruction) • You might write: 

CLEAB GF ai TO SET OFTIOIS 
SET BTTE COUIT 
Sn EITEB COBB II 6P BIS 
IIBE 



EBBOB — Indicate Supervisor Detected Error fOI 

The EBBOB macro instruction provides the means bf which the resident 
supervisor reports the occurrence of a major or minor software error, a 
hardware failure, or an I/O error. 

J J . — J 1^ . , J 

I lane | Operation (Operand | 

I 1 ^—i 1 

|[sfnbol]tEBBOB {error tfpe,fillin,nessage id, call id | 

I 1 . — I ,1 

error tf pe 

specifies the tfpe of error that has occurred. 

Specified as : One of the codes shown in figure 24. 
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SB 


m 


LI 


0,256 


U 


15,48 


EITIB 





I Type of Error 

I- 



IHlnor software error 
I Major software error 
I Hardware failure 
I Issue message 

I 



figure 24. System error codes 

fillin 

this operand must be included for compatibility. 

Specified as ; luy two-digit decimal number in tlie range 00 througb 
27. 

message id 

specifies a unique identifier for the message to be issued as a re- 
sult of inwoking the IIROE macro instruction. 

Specified as ; A two-digit decimal number in the range 01 through 
99. 

call id 

specifies a specific EllOl call in modules that issue more than one 
call. 

Specified as ; k decimal number in the range through 99. 

Mote ; Both ifPSl and EBBOR use the same S¥C code (254J ; an S?C 25«> oc- 
curring in the problem state is c3onsidered L¥FS1| an SWC 254 occurring 
in the supervisor state is considered EBBOB. 

Execution; SfC 25*1^ generated by the EBBOB macro instruction^ is the 
only SfC that may be issued by the resident supervisor. The processing 
unit receiving the SVC will stop all other processing units in the sys- 
tem. A message (for its format, see "Syser Dump" in Part I, Section ft) 
is issued at the operator's terminal and the system enters the wait 
state; a dump may then be taken. 

If the error type is 1 (minor software) , or if the recovery nucleus 
returns control to the STC 251 routine, all other processing units in 
the system are restarted; control is then returned to the instruction 
following the EBBOB parameter list. If the error type is 2 (major soft- 
ware), the system is suspect, and the IFL process must be initiated by 
the operator. If the error type is 3 (hardware failure) , the error is 
handled as a type-2, but the word SOPflABE in the message is changed to 
BABBIABE. If the error type is 7, the system is stopped, a message is 
immediately written to the operator console, and the system is re- 
started. See the example below to learn how to set up the message. 
This is primarily used for an I/O failure, to inform the operator of 
some action to take concerning the failing device. 

Example ; To send a message to the operator, you might code: 

SEIBHESS EBBOB 7,0,0,0 
OBG *-3 
DC JIL3 (MESSTEXT) 



HESSTEXT DC IL1 (ft) lESSlGE LElGf H 

J>C C»HBIP» 



IftO 



Programffliiia Mote ; Fart of the message issued at the operator's terminal 
is a four-digit error code; this code is formatted from the two-digit 
■essage id and the two-digit call id passed to the system error pro- 
cessor as parameters of the BllOl macro instruction • This construction 
permits fou to identify calls to the systea error processor for debug- 
ging- lou mighty for example, assign one module or one group of modules 
in main storage a particular module identifier to permit its recognition 
as the source of thcs call* Xou could then, using the call id operand^ 
assign sequential numbers to the EHSOl calls issued by that module or 
group of modules to help you recognize particular errors resulting in 
calls within the sequence. For example, you might write: 



BBIOB 



I I- 



-message id 
-call id 



and the resulting error code, 2310, would identify the error that 
resulted in the call to the system error processor. 

To avoid issuing different EElOl calls with the same error code (thus 
duplicating the messages issued at the operator's terminal and creating 
confusion as to the reason for the callj , check System Hessaaes for 
those error codes already in use in the system. 

Example ; Suppose you detect a major error — quantity I was neither 
less than, equal to, nor greater than quantity B. You might write: 



BLIST 



BlROl 



3,01,23,02 



ISBG — Exchange Hamed Segment CQI 

The BSEG macro instruction transfers control to the exchange named 
segment program in the resident supervisor. In attempt will then be 
made to exchange the specified disconnected segment group with the vir- 
tual storage segment specified. 



-I r 

(Operation | Operand 



iVame 



I BSEG I 
-i 1- 



note : There are no operands. 

Initiali zation : Before executing BSEG , the issuing program should have 
set up the following parameter area: 



CHJklSG 



DSBCT , 
BS OF 



MSGSVC DS 

ISGFLG DS 

tfSGGET EQO 

IS6GETII EQU 

ISGPOT EQO 

ISGPUTH EQO 
OS 



H 

I 

ISGFLG 

1»B0" 

ISGFLG 

I»40« 

X 



COmOM IIHESEG PAllMETEl LIST 

SVC 
FLAGS 

GET OISCOHECTBD SBGIEIIT P&GE 

POT DISCOMIECTEB SEGIEIT PAGE 
BBSEEVEO 



HSGIHI OS IL8 lESElVBO SEGIEIT GfiOOP MIME 

MSGDII OS TLB OXSCOSHECTBO SEGMEWT GIOOF IIEE 

ISGVEl OS I VIITOAL STOIIGE AODEESS OF SEG GROOP 

ISGLIG OS H LEIGTH OF HAIEO GBOOP 

ISGFLI OS ILl IIFOT FLIGS 
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ISGPLO 


DS 


ILl 


MSGDHGM 


BQO 


X«80» 


HSGRIGM 


EQO 


xtirat 


HSGIDGH 


EQO 


X«20» 


MSGBIDH 


BQU 


XMO» 


ISGLMGH 


EQO 


X«08» 


MSGIBLH 


SQO 


X«04» 


HSGRESSM 


EQO 


X»02» 


HSGBTJl 


DS 


f 


SSGLTH 


EQU 


*-<:hi 



OUTPUT FLAGS 
DlllE SPECIFIED 
ElAME SPECIFIED 
IDDHESS SPECIFIED 
!!0DE=B0U1ID 
LENGTH SPECIFIED 
RELEAS=f SPECIFIED 
BSTRCT=f SPECIFIED 

GET/POT SEGHEIT BOFFER ADDRESS 
*-CHAMSG LENGTH OF PAIAEETIR LIST 

ESEG nust be tke object of aa execute iastructioa and be fullword 
aligned* 

Execntio B: This aacro iastruction passes control to tke resident super- 
visor sodnle CEAP8 via S?C ^185. An attempt will then be made to 
exchange the specified disconnected segment group. 

Proaranainq Note ; ESEG is an inner aacro used with the EXCSK5 aacro 
instruction. 



EXCSEG — Exchange Segment Gronp iO\ 

This aacro instruction is completely documented in the Assembler Oser 
Macro Instruction manual ^ except for one operand that is available onlf 
to a sfs terns programmer. The definition and specification for onlj that 
one operand are given below^ but for continuity^ the metalanguage format 
that follows shows all the operands. 

L~form 

I 1 1 1 

INaae | Operation | Operand I 

I 1 1 ^ 1 

fSymbol fEXCSEG J[ DNAME=^LBNGTH=^BOaND=^RNAlSB=^RELEAS = , ] HF=L | 
I 1 1 1 

E-fora 

I ^ — I ^ 1 ^ 1 

I lame | Operation (Operand I 

I 1 1 ^ 1 

f[syabol jJEXCSEG |[DMAlE=,LEiGTS=^BO0MD=,SMAME=,ADDRESS=,HELEAS=, ] | 

I I I MF= (ENLIST) I 

I ^ 1 I ^ —I 

Standard -Fora 

• 1 1 ^ i 

INaae |Operation| Operand I 

I ^ ^_ 1 ^ 1 

|[syabol ]|EXCSEG |DNAHE=[, L1»GTH=,B0UND = ^RMME=^ADDRESS = ^EELEAS= ^ ] I 

I 1 i ^ I 

Mote ; all operands are keyword. 

RBLEAS= 

specifies whether or not the reserved segment GETMAIN restriction 
is enforced while the named segment group is disconnected. 

Specified as ; 

1 — the reserved segment GETMAIN restriction is not enforced. 
N - the reserved segment GETMAIil restriction is enforced. 
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I Default : K 

I This option is available to privileged class programs oeIj. lefer 
I to GOTIAIH and ISVSEG macros for further explanation. 

EXPMD — Expand Page (01 

The IXPID macro instruction transfers control to the Expand Page Pro- 
gram (Ceapl) in the Besident Supervisor- In attempt will then be made 
to allocate additional virtual aemorj address space contiguously to ex- 
isting virtual memory address space. 

I ^ — I 1 ^ 1 

IMame (Operation [Operand I 

I , 1 ^ ^ ^ ^ 1 

|[ symbol irEXPHD | I 

I I . i . ^ . . I 

note: There are no operands. 

Initiali zation : Before executing EXPlDt the issuing program should have 
set up the following general registers: 

Reg ister Contents 

existing number of pages (left half) 
additional number of pages (right half) 

1 starting virtual memory address of existing space 

15 protection code for additional address space 

(see IDDPG macro description) 

CAPTIQI : The existing virtual memory address space must be currently 
allocated. 

Execution: This macro instruction passes control to the Resident Super- 
visor Module CEIP1 via SVC 239. In attempt will then be made to alloc- 
ate the specified number of additional virtual memory pages contiguously 
to the existing address space. 

Beturn Data : 

Register Contents Heaning 

1 virtual memory address 

of first page allocated 

15 allocation ok 

^ request not satisfied 

Programming Mote : The system programmer should use the expand entry 
point (CZCGI4) in VIA to expand virtual memory. 

Example : Suppose two additional pages of privileged virtual memory are 
needed contiguous to the virtual memory address contained in general 
register 4. The following instructions may be written: 



L 0,=I (X«000 10002 •) 
LR 1,4 
LI 15,2 
EXPID 
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LTH 15,15 

BUZ HOTALLOC 



FIMISH (ES&KI — End of Data Set (Bl 

The FIHIsa macro instruction is used to inform the HS&M routines that 
processing of the current data group (a subsection of an ESI!! data set; 
a complete data set to the user of the unit record device) is at an end. 
I task may process more than one data group (within the same ESAB data 
set) with the same data control blockr without closing and reopening the 
DCB (and the assignment and release of the associated I/O device) be- 
tween data groups- 



I ■ 1 — ^ 1 

I lame [Operation! Operand 



|[ symbol ]|FIIISH |dcb address 

t i . — 1 



deb address 

specifies the address of the data control block opened for the data 
set being processed. 

Specified as : An RX address , or as register notation. Execution 
time may be saved if register 1 is specified. If register notation 
is used, the address must first be loaded into the specified 
register. 

CAPTIQM ; The FIHISH macro instruction causes the operator to be noti- 
fied to remove the data group from the device in use if the IISMSG flag 
of the data control block is not set to 1« 

leturn Data ; Upon completion of the FIHISH macro instruction^ a code 
indicating the manner in which the instruction was completed is returned 
in register 15. The meanings of the codes are given in Figure 25. 



142.2 



i I 
let urn | 
Code I 

1- 



Hea&ing 



I Operation cx>Bpleted success f nil j* CLOSl nacro instruction aaj 
I be issued, or £nrtlier processing naf be initiated withont 
{reopening data control block i the BCB parameters LRICL, HODB, 
rST&CK^ PITSP, llCFl^ FOCKIT, fOllTYFl^ and IBflY nay be 
(altered at this tine. 



^ 



(Operation vas not completed since I/O vas not finisked* 
IFIVISH macro instrnction sbonld be reissued later, until a re- 
(tnrn c€)de otber than 9 is received. (See discussion of *'In- 
(terruption Entry Handling ,» above.) 

+ 



(Operation vas completed vitk I/O error. If data control block 
I vas opened for input, description of 61f macro instruction re- 
(turn code of 8 (Figure 26) applies; if data control block vas 
(opened for output, description of FOf macro instruction return 
(code of 8 (Figure 39) applies. In order to clear remaining 
(output buffers, if error vas not permanent (D1BVF2 or BBC61 
(not on), FIVISH may be reissued. 
I 1 . ^ I 

Figure 25. Return €x>des for HSAH FIVISH macro instruction 
Programming Botes : The FIlISH macro instruction provides for: 

• Initiating any necessary I/O activity so tbat an output data set may 
be closed. 

• testing the results of all outstanding I/O on an output data set. 

• Ivaiting completion of outstanding I/O reguests on an input data 
set. 

• lotifying an operator to remove the data set from the device (under 
control of the IVHHS6 flag of the data control block) . 

• leading a c:ard from the card reader and stacking it in pocket 3 of 
the same 2590 as the selected punch, if the COHBIVB flag of the data 
control block is set. 

lott should precede the ClOSB macro instruction vith the FIVISH macro 
instruction, if you vant to avoid an automatic vait condition, vhich may 
result from the access method CLOSB, or to receive notification of any 
I/O error. (Close HSIB is the only HSIH routine to invoke &VAI1!.) 

Example : The folloving example is based upon the coding in the example 
for the PUT macro instruction. It vould follov the locate-mode PUT, L, 
BE: 



LI 7,FIVTIB 

IBPBIT FIVISH JHL 

L 5,0(15,7) 

BR 5 

HILT CLOSE JHL 



SET 0P BRIVCH TABLE 
EVD OF BITI SET 
BIAICH OV EC IVDEI IIB 
FIVTAB AS BASE 



FIVTAB 



BC 


A (HALT) 


BC 


A (REPEAT) 


BC 


A (ERROR) 
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ABDR FOR PIOCESSIVG AFTER 

RC OF 

ADDR FOR PROCESSIVG AFTER 

RC OF 4 

ABBR FOR PR0CBSSIV6 AFTER 

RC OF 8 
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1 1 ■ ■ ■ ' ■ ■■"" - — "^ 

1 letQrn | | 

1 Code 1 Heaning | 
• 1 ■ 


1 I f 

I |Operatio& coapleted successf ullj • | 

II ■ 


|- i- -| 

1 il |I/0 not coapleta; no record has lieen provided since next | 

1 1 segneiitial buffer has not jet been filled; GET nacro instrnc* f 

1 ttion sbonld be reissued. | 
1 1 ■ 


r ' 1 ., , , 1 

1 8 |llnre€:o¥erable I/O error occurred in connection with record be-| 
1 ling read; noraallj , CLOSE nacro instruction should be issued; f 
1 1 however, a record has been provided, content of which is buff-| 
1 fer image. If I/O error was not pernanent (D1BHF2 or D1CG1 not| 
1 |onJ , fou naf accept record and continue processing, or fou najl 

I iBl^ip record bf issuing another GET wacro instruction. | 

II ■ 


II 1 

1 12 |End-of-f ile; no recor€ has been provided. The FIIISH wacxo | 

I linstrucrtion should be issued. | 

II ■ 


1 1 ■ ' ' " ' 1 

1 16 IControl card sensed: atteapt to read an EBCDIC reisord | 
1 Iresulted in validitj check; first four colunns of card contain! 
1 Isaae predeternined control Bark, a 12-11-3-^ punch. Becord | 
1 (provided is buffer inage, control bftes of which should be | 
1 1 tested for such installation --defined codes as (1) change of | 
1 iBode fron EBCDIC to coluwn binarj or (2) change of data group | 
1 (without end-of-file indicator. Depending on installation as- | 
t Isignnent and control code usage, processing naj continue* t 
1 (Control card will be stacked as if it were valid data card. | 
1 (If subsequent GET nacro instruirtion is issued, it will refer ( 
1 (to next card in reader following control card. If auf fields ( 
1 |in data control block are to be changed, FIIISH for CLOSE and | 
1 (OPEI) macro instrucrtions must be issued before the next GET. | 



Figure 26. Be turn codes for ISAM GET nacro instruction 



FBEELQCK 



Open a Be side nt Supervisor Service fOl 



The FBEELOCK macro instrucrtion opens a specified resident supervisor 
service that is currentlj locked, thus allowing the service to be used 
bf another processor. 



• 1 ' ' ' " 1 " 

I lame (Operation (Operand 
I , 1- 



([sfmbol]( FBEELOCK (lock area, register, module id, error number 



lock area 

specifies the address of a double word {8 bftes, fullword aligned) 
that is a crurrentlf locked service lock area. 

Specified as ; a sfmbolic address. 

register 

specifies a register to be used for logging the FBEELOCK address. 

Specified as s an absolute expression from to 15. 

module id 

specifies the module opening the resident supervisor service (the 
module in which the FBEELOCK is issued) • This operand will be used 
in generating a SfSEB message in the event the lock area is irur-* 
rentlf free or locked bf some other CPU. 
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Specified as ; a two-iigit decimal number* 

error nuftber 

specifies tliis particular FBIEIOCI aacro instrmrtion withia a 
module in vliicli more tkan one STSll is issued, this operand is 
used in generating a SYSSl message in tlie event tlie lock area is 
currently free or locked bf some other CPU. 

Specified as ; a two-digit decimal number* 

Programming Wote ; The double vord serrice lock area has the following 
structure; 

J J 1 . "1 ' 1 

I lock i not I address of last CPU | address of last 6ETI.0C1C or | 
I bjte I used | to access lock area | FIESLOCK to access this lock areaf 

I i 1 ^ ^ 1 . i 



GET fHSAHl — Set a Becord fll 

The GET macro instruction maj be specified in either the locate mode 
or the move mode* then fou speciff the macro instruction in the locate 
mode, GET locates the next sequential record in the specified input data 
set and places its address in register 1* When you specify the macro 
instruction in the move mode, GET locates the next sequential record in 
the specified input data set and moves it to the work area fou have 
specified in virtual storage* 



I 1 1 

I lame [Operation | Operand 



I [ symbol ]| GET | deb addr ess[ , area J 

I I ^i ^ 



deb address 

specifies the address of the data control block opened for the data 
set being processed. 

Specified as ; In IX address, or register notation (1 through 12) . 
Execution time is saved if register 1 is specified. If register 
notation is used, the address must first be loaded into the speci- 
fied register. 

area 

specifies the address of the work area into which you want the rec- 
ord to be moved. Use of this operand implicitly specifies move 
mode. 

Specified as ; In 11 address, or register notation (0 or 2 through 
12) . Execution time is saved if register is specified. If 
register notation is used, the address must first be loaded into 
the specified register. 

Initialization ; The address of a save area must be placed in register 
13 before executing the GET macro instruction. 

When you are using HSIH, the GET macro instruction may only be em- 
ployed to obtain records from a card reader. The BECEE field of the 
data control block must therefore indicate format-f , sinc^e format-¥ does 
not apply to the card reader. It OPEl, the IBECL field of the data con- 
trol block should be set to a maximum of 80 bytes for EBCDIC, or 160 

Section 2; System Bacro Instrucrtion Descriptions 115 



bytes for columik biiiarj. The aode field ia the data control block Must 
be set to a biaarf for EBCDIC or to blaary 1 for cxilaan biaary . 

Betura Data s Upoa cx^apletioa of tbe GET aaero iastractioa^ a code iadi- 
catiag the saaaer ia which the iastractioa was completed is returaed ia 
register 15. „ Heaaiags of the codes are givea ia Figure 26, 

Example ; la the followiag example, which illustrates the use of both 
the locate-Bode aad aoTe-Bode GST macro iastructioas, you waat to read 
65 EBCDIC bytes from the first 65 columas of the aezt sequential card, 
in a 2540 reader* lay cards with errors will be stacked ia bia 2, with 
ao attempt to reread the record; cards coataiaiag ao errors will be 
stacked ia bia 1. Siace the retura erodes provided from the macro ia- 
structioa are multiples of 4, it is possible for you to set up a branch 
table to provide proper coatrol of processiag. 



IDl 


DCB 


DS01G=^1S , 11C1F=G , 

DD111E=1YDD,DE¥D=1D, 

10DE=E,P0CKET=2, 

STICK=1,1ECF1=F, 

L1ECL=65 




OFEl 


(IDL, (IIPUT)) 




Lk 


3,1CT1BLE 




LI 


1,iDL 


10? E 


GET 


(1) ,10RE 




L 


5,0(15,3) 




BS 


5 


LOCATE 


GET 


IDL 




L 


5,0(15,3) 




BE 


5 


iORK 


DS 


CL65 


ICTABLE 


DC 


& (lOlH) 




DC 


k (PAUSE) 




DC 


k (EBlOl) 




DC 


t (BID) 




DC 


I (COITIOL) 



BOILD DCB 



OPEl DCB 

SET 0F BEAICH TABLE 

LOAD A DDE OF DCB 

lOVE-HODE GET lACEO 

BIAICB 01 EC IHDEX A9D ICTABLE 

AS BASE 

LOCATE -MODE GET HACIO 
BEANCH 01 IC IIDBX AID 
EC TABLE AS BASE 



IIPDT AREA FOR MOVE-MODE 

GET MACRO 

ADDR FOR PROCBSSIIG AFTER 

RC OF 

ADDR FOR PROCESSIIG AFTER 

RC OF 4 

ADDR FOR PROCESSIIG AFTER 

RC OF 8 

ADDR FOR PROCBSSIIG AFTER 

RC OF 12 

ADDR FOR PROCBSSIIG AFTER 

RC OF 16 



Both the move-mode aad locate-mode GET macro iastructioas result ia 
type-1 liakage to the DOES AH routiae. 



GBTADDR — Get System Address from CVT 

GET ADDR loads the specified register with the address of the speci- 
fied symbol from the C?T coatrol block. 



I lame | Oper atioa | Operaad 
I 1 1- 



I [ symbol ]|GETADDR |[EPT=] [,R=1 



EPT= 



aame of the system symbol whose address is aeeded. 
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1= 

the register into whick the address of the s3f«bol Csj^ecified in 
1FT=) is to be placed. 

Specified as ; Anj register ^ except legister cannot be used if 
C¥T lO was coded* 

Default : legister 15 

CAPf lOHS : the PSI dsect CHAFSI nnst be copied in the assenblf using 
61T1DBB. fhe expansion of 61T1DD1 is affected bf the use of the CV7 
nacro prior to the use of 6ETIDB1. 

Currently y onlf those system symbols starting with the following three 
letters ha^e been placed in the CTT: 

CE& 

CHB 

SCI 

CIP 

Exanple ; 

(1) fo get the address of entry point CSlTll and place it in legister 

5 (assuming CTT TIS) , yon might write: 

GlTIDBl lPT=sCBJlTI1 ,1=15 

♦ L l5,CffTI1 

(2) To get the address of the core block header in legister 10 (assum- 

ing CVT 10) yon might write: 

GlTIDDl EPT=CHBCBH,1=110 

♦ I, iio,ps&cvth:hipsi(,0) 

4- L 110,C?TCB1-CH1CVT(,110) 



GETCOBE — Allocation Snpervisor Storacie Space 

6ETC01E calls C1&L1JI (Supervisor Illocmtion) to request allocation fo 
a given amount of storage. Storage is allocated in blocks of 64 bytes 
with a maximum length of 4096 bytes. 

I I 1 ^ ^ ' 1 

flame | Operation (Operand I 

I , -I ^ 1 

|[symbol]|GETC01E |[LGH] f^TXPE^l [,1ET!I1I=] [,11101=] \ 

I 1 ji , 1 

LGB 

the amount of storage to be allocated. 

Specified as : any number greater than and less than or egual to 
4096. lay be a register (0 is allowed) , half word, fullword, self- 
defining expression or an BQO. 

TyPE= 

amount of time the storage space is to be in use. 

Specified as : S, 1, or I.. 

S/SHOll " core is to be in use a short time only — about one or 
two cycles through the supervisor. 

l/MEDIUl - core is to be in use longer than a supervisor cycle or 
two, but less than the possible life of a task. (Host X/0 falls 
within this time length.) 
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L/LOMG - core is to be in use for a long time, or the life of the 
task. Examples are TSIs, 7SDL page, fCTs, shared page tables, etc. 

Default: S. 

117011= 

indicates to sfstem whether or not to return if sufficient storage 
is not available to fnlfill request. 

Specified as ; 

1 - return if sufficient storage is not available; £1101 (see 

belov) must also be coded. 

I - do not return if sufficient storage is not available. 

Default ; I. 

E1101= 

label of the 'branch to* if storage space cannot be allocated; 
valid onlf if 11T!I11I=T. 

CA07I0HS ; 
(1) 7he PSl dsect CHIPS A must be copied in the assemblf containing the 

GETCOIE macro. 
C2) fhe expansion fo this macro is affected by the use of the CVT macro 

prior to the use of this macro. 
(3) If the system is unable to fulfill the storage request and •lEfUll« 

M • , then the system will be terminated with the major syserr 571 . 

letum Data : 

Length of the storage area allocated is in legister 0. 
Address of the storage area allocated is in legister 1. 

Examples : 

(1) Using self -defining term for length of request 

GITCOIE 6i|,TlPB=I. 

results in 6% bytes being allocated from the long term storage 
chain. 

(2) Using a symbol pointing to the length, and return requested 

GITCOIE LGH1 ,TYPE=H,1ETII1I=1,E1101=H0C01E 

lOCOlE DS OH 

* recover; sufficient storage not available 

LGH1 DC FM024* 

results in 1024 bytes of storage being allocated. If unable to 
allocate, CEIL 1 A will return to caller and the GETCOIE macro will 
automatically branch to the lOCOlE label. 



GETLOCK — Lock a lesident Supervisor Service iOl 

The GETLOCK macro instruction locks a specified resident supervisor 
service, thus serializing the service in a multi -processor environment. 

148 



I 1 T 

I lame | Op eratloE | Operand 

I , ^ 



i[s7Bbol]f(^fI.0Cl ilock area, regis ter,|[BodQle id ],[ error number], 
I I {IlllDIITllWIIT} ,[ action], [exit address] 



lock area 

specifies the address of a double vord (8 bjtes, fullword aligned) 
that is the serTice lock area. 

Specified as ; a symbolic address. 

register 

specifies a register to be used for counting tine increments and 
for logging the SITLOCK address. 

Specified as ; an absolute expression from to 15. 

module id 

specifies the module trying to lock the resident supervisor service 
(the module in which the getlock is issued) • This operand will be 
used in generating a STSSl message in the event the attempt to set 
the lock byte is unsuccessful, fhis operand is required if the 
l&If operand is specified; it is ignored it the immediate operand 
is specified. 

Specified as ; a two-digit decimal number. 

error number 

specifies this particular GETLOCl macro instruction within a module 
in which more than one SlSSl is issued, this operand is used in 
generating a STSSB message in the event the attempt to set the lock 
byte is unsuccessful, fhis operand is required if the HIT operand 
is specified; it will be ignored if the IHHIBIATE operand is 
specified. 

Specified as ; a two-digit decimal number. 

IHHBDIITllllIT 

specifies how long to keep trying to set the lock in the event it 
is already locked. 

Specified as ; 

IHHEDIATS — only try to set it once 

HIT ~ keep trying until a length of time has elapsed 

action 

specifies what to do if the attempt to set the lock fails. 

Specified as ; a symbolic address to which to branch if the IIMEDI- 
ITE operand was specified. 

exit address 

specifies where to branch to if the lock was set or if a SYSEl 
occurred. 

Specified as ; a symbolic address. 

Default ; The program continues at the next sequential instruction - 

Programming Mote ; The double word service lock area has the following 
structure ; 
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I p p 1 , ^ 

I lock I not I address of last CPU | address of last getlock or | 
r bjte I used | to access lock area | FREILOCK to access this lock area| 
I 1. I 1 I 



GETPA6 — Get Virtttal Heaorv Page 

61TPJIG sets up a parameter list and calls C1&TC7 to reguest all 
pages, defined bf a virtual nemorj address and length, be brought into 
storage and placed in page hold. 



I 1 1 

I laae ( Op eration | Operand 

I 1 1 

I [ symbol IIGITPIG |TSI=,!PCW= 



address of the locked fSI for the owner of the pages. 
Specified as ; an IX address or register notation 

address of a parameter list for CllfCT containing the starting vir- 
tual memory address and length of the area needed to be held in 
storage . 

Specified as ; an IX address or register notation 

CAPf lows ; The PSI dsect CHIPSI must be copied into the assembly con- 
taining the 62TP&6 macro. The expansion of this macro is affected by 
the use of the CTT macro prior to the use of this ma<;ro. 

programming Bote ; The dsect CHITCW describes the TCW parameter list 
area. 

Execution ; Using the parameter list spe<:ified by TCI and described by 
the CHITCW dsect, CSITC7 builds a parameter list for CSIHQ and maUces a 
type "C* c:all to CSJkHQ to read the needed pages and place them in page 
hold. On return from CEAEQ, CE1TC7 fills in the associated real core 
addresses and lengths in the TCW parameter list. 

Hetum Codes ; The return codes in legister 15 are; 

Code Meaning 

successful reguest 

negative paging error; exit 

i| invalid ?1A given 

GETWORK — Get Temporary Work Area 

The GETWORK macro allocates a temporary work area of specified length 
from the supervisor save area stack. 

J J J . — ^ 

I lame (Operation (Operand I 

I , 1 1 

I [symbol II GETWORK |LGH [ ,B1SE=] I 
I I t 1 

LGH 

length of work area to be allocated. 
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Specified as ; a rniaber that is a multiple of 4, or a sfsbol that 
is defined on a fullword bomndarj. If given as a iiiiBl>er that is 
not a multiple of four, this macro rounds the number to the next 
higher multiple of four. If given as a sjmbol, it is the program- 
mer's responsibility to make sure the symbol is defined as a full- 
word to maintain a fullword boundary* 

B&SE= 

the register in which the work area address is to be returned. 

Specified as ; Register 1 through 15; is not allowed. 

Default ; Begister 1 

CAOTIQHS ; 

Cl)The PSA dsect CHIPSI must have been copied prior to the use of this 
macro. 

(2) 1^he Gl!rW0Bi: macro should not be used in a loop. 

Procrrammincr Hotes ; There is no macro for freeing space allocated by the 
GBTWOIK maisro. then the module exits, the save area stack is ••popped" 
which automatically frees the work area. 

Examples ; 

(1) To allocate a temporary 8-byte work area, code; 

GlflOlK 8 

legister 1 upon exit from the macro will contain the work area 
address. 

(2) To allocate a temporary work area and have the address returned in a 
register other than register 1, code; 

GETIORI 64,BISE==12 

Begister 12 upon exit from the macro will contain the address of the 
6«l-byte work area. 



GMC — Get next Character (01 

The 6NC macro gets the next character from the command system's 
source list, tests it for a specific function character, and if not a 
specific function character, makes it available to the macro user. 



I 1 r 

I Hame | Op er ation | Operand 



Ilabel IGHC |[exit] [,attn] 

I i L, . . 



exit 

the label of the branch-to if the source list is to be refreshed 
because the end of the current level has been reached. 

Specified as ; an BX address. 

Default ; get the next character. 

attn 

the label of the branch-to if the source list handler detects an 
attention from the user while processing the source list- 
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Specified as : aE IX address* 

Default ; ignore, aad get the next characrter. 

PrograEttipg Mote ; The GIC aacro mses registezB 1, 14 and 15. The macro 
expects the user to have issued a USIHG and a COPY for the dsect CHiSLHi 
Jllso, the user aust copy the dsects CHMTC and CH&PCT* The GKC macro 
does a OSIIIG for CHAITC using register 15 and a drop on register 15. 
The text character is returned to the user in register 1. 

Executio n; GSC retrieves the character pointed to by the address in 
SLHCSA* The character is tested for an •EOB» (X»26»). If it is and the 
following character is not an »E» C2ISC3 is called to process the source 
list marker. On return from CZ1SC3, the return code is tested for pos- 
sible exit conditions. If no exit conditions exist or if an exit or 
attn label were not given , GSC attempts to retrieve the next source list 
character. If the following character is an •£• the macro exits to the 
user with the EOB character in register 1- 

If the retrieved character is not an EOB, a test is made to determine 
if the character is a continuation character by testing against the 
user's appropriately-defined character in the Profile Character Table 
(CHIPCT) . If the character is not a continuation character, GIC exits 
to the user after updating SLHCSl to point to the next character. If 
the retrieved character is a continuation and is followed by an •EOB,E* 
seguenoe (I*26C5) , the SLHCSA is updated to point to the EOB,E seguence 
and CZilSC4 is called to process the E marker (i.e., the "EOByE* 
seguence) . On return, the return code is tested for a possible exit 
condition, if exit or attn were specified- If not specified or the exit 
condition is not satisfied, the next character from the source list is 
retrieved. 

I GPSEG — GET/POT Mamed Segment fOl 

I The GPSEG macro instruction transfers control to the GBT/PSJT named 
I segment program in the resident supervisor • An attempt will then be 
I made to get a page from or put a page into the specified disconnected 
I segment group. 



I I lame 



-1 1 

t Operation I Operand 



h 



I GPS EG 



I 



I £ote* There are no operands. 

I Initiali zation ; Before executing GPSEG, the issuing program should have 
I set up the following parameter area: 



CHIISG 

ISGSfC 

ISGFLG 

l^GET 

ISGGETH 

ISGPOT 

ISGPUTl 



BSBCT , 
BS OF 



BS 

DS 

EQB 

EQB 

EQB 

BQP 

DS 



H 

X 

NSGFI.G 

ll»80« 

ISGFLG 

I«40» 

I 



COIHOI MIHESBG PIEIMETBl LIST 

S?C 
FLIGS 

GET BISCOIMBCTEB SEGIEHT PAGE 

PUT BISCOIMECTEB SEGIEHT PIGE 
EESEBfEB 



t 1:%1HA BS 1L8 lESElfEB SEGMEIT GROUP l&BE 

I MSGBIA BS XL8 BISCOHMBCTEB SEGIEHT GIOBP HUE 



HSG7M& 



DS 



VIHTBIL STOl&GE IDDBESS OF SBG GIOIP 
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MSGLMQ 


BS 


H 


ISGFLI 


DS 


XLI 


NSGFLO 


BS 


XL1 


MSGDIGM 


IQO 


X»80» 


MSGHWGM 


EQU 


X»ftO« 


MSGIDGl 


IQO 


I«20» 


ISGBIDM 


EQB 


I»10» 


HSGLMGH 


EQU 


X»08« 


HSGIBLH 


EQO 


X»04« 


MSGSESSH 


EQU 


X«02» 


HSGBfl 


DS 


F 


HSGLXa 


IQO 


*-cai 



LBIGTH OF mi ED GfiOOF 

IIFOT FLIGS 
OOTPOf FLIGS 
BlIEB SPECIFIED 
EIIME SPECIFIED 
IDDIBSS SPECIFIED 
HODB=BOOIB 
IBMGTK SPECIFIED 
1ELEIS=¥ SPECIFIED 
lSflCT=Y SPECIFIED 

GET/POT SBGHEIT BOFFER IDDRESS 
LEU GTE Of PlBlMBfEE LISf 



GPSBG mxist be the object of aa execute instructioa and be fullword 
aligned. 

ExecjitioB: fkis aacro instrtiction passes control to tke resident super- 
visor ttodmle CE1Q8 via SVC 186 • In atteapt will then be made to get a 
page from or pnt a page into the specified disconnected segment group. 

BOOK — transfer Control froa IVM to Private Module (0) 

The HOOK macro instruction, when placed at each executable entrf 
point of a new IVM module, sets up the aechanisa to transfer control 
from the system version of the module to a private version of the same 
module. 



-T r- ^ — 

I Operation | Operand 



flame 
I- 



+-' 

|[NL] 



I [symbol ]|a00K 
I 1 



ML 

indicates that the user does not want the symbol specified in the 
name parameter to be generated on the first executable instruction 
of the macro expansion. 

Specified as : ML, or it is left blank. 

Default ; The simbol, if specified in the name parameter, is 
generated. 

Programminct lote : The most important part of the •hook^ process is the 
existence of the HOOK macro at every executable entry point in the I?M 
module. 

ID — Define BOLKIQ Module ID 

The ID macro instruction defines a variable global identifier (BULKIO 
section ID) . This identifier is used by other macros unique to the BOL~ 
KIO modules. 
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1 — ^ 1' 

lame | Op exrati on {Operand 



I IB I module Id 

J 1. 



■odiile id 

the variable global identifier. 

Specified as ; an alphabetic character from I to Z,^ corresponding 
to the last character of a BULKIO module CZIff (&/Z) • 

IHVQKE — transfer Control fOl 

I I ■ ' " ' II I ■ ■ 

IlVOIl transfers control from one program or routine to another by 
means of the BASE imstmction. 



I 1 1' 

I Vame {Operation | Operand 

I 1 1, 

I [ symbol ] | IB ?0K£ | address 

I 1 1 



address 

specifies the address of a word that contains the address of the 
program to be jjivoked. 

Specified as ; In IX address^ or as register notation- If register 
notation is usad^ the address must first be loaded into the speci- 
fied register* 

Bxecntion; The specified address is placed into register 15 and a BASE 
1<lr15 is generated. 

lOCAI. — I/O Call fill 

The lOCM. macro instruction provides for the initiation of an I/O 
operation. 



I 1 "■? 

I lame | Operation | Operand 

I f- 



i[ symbol II lOCAL | 

I I IL 



Bote ; There are no operands. 

Initialization ; I BCIISS macro instruction with the PIIVILIGEB option 
must be coded in a module prior to coding lOCAI.. If more than one 
BCLISS macro instrucrtion is issued in a module, the last BCIISS issued 
prior to coding lOCIL must be issued with the PHIflLlSBB option. 

Execution; In lOCII. macro instrucrtion must always be the subject of an 
Execute inst^ruction • the supervisor call instruction (S?C 231) is 
assumed to occupy the first halfword of a variable-length parameter list 
called an I/O request control block CIOICB) . The lOBCB supplies the in- 
formation needed by the supervisor to perform the requested I/O opera- 
tion. This control block is described by the BSECT CHIIOl. 

In lOlCB consists of four parts; a fixed part of 10 doublewords; an 
optional I/O data buffer which cannot exceed 225 doublewords; an option- 
al page list which cannot bxcbbA eight doublewords; and a channel com- 
mand word (CCl) list. The entire lOlCB cmnnot exceed 240 doublewords 
and must be contained within a single page. 
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When aa lOCIL is executed, the supervisor, after soBe error checking, 
obtains nain storage for the lOlCB and copies it into that space. Based 
on the options selected bj the user and indicated in the lOECB, the sn- 
pervisor obtains a path to the requested I/O device, translates the vir- 
tual CCW addresses to real storage addresses, brings any required buffer 
pages into nain storage, and starts the I/O operation. After the I/O 
operation is complete, the supervisor releases the device path, allows 
the data buffer pages to be paged out of storage if necessary and queues 
a pending task -I/O interruption for the task associated with the lORCB* 

When the pending interruption is accepted by the task, the supervisor 
copies the lORCB into the task's interruption storage area (IS&) • After 
the lORCB has been copied, the sain storage it required is released and 
the lOCAL operation is conpleted. A task aay have more than one lOCAI. 
in operation at one time and may operate asynchronously vith an acrtive 
lOCAL* 

Figure 27 shows the format of the fixed area of the lOlCB as it is 
before an lOCAL. Every lOCAL must have a 20-word fixed area regardless 
of the fields used. You may use space within the lORCB itself as a data 
buffer; you can do this if the data does not exceed 225 doublewords (or 
whatever space is left in the lOlCB after the other items you need are 
included) • lou must include an lORCB data buffer if you are using a di- 
rect access device and if you wish record zero to be read into the lOBCB 
by the supervisor if a unit check occurs. In this case, the lOlCB data 
buffer (the first 56 bytesj is used to hold record zero, lou may also 
use data buffers outside the lORCB; if you do this, you must include a 
page list. The page list contains one doubleword entry for each virtual 
storage buffer page; you may not have more than eight page-list entries, 
figure 28 shows the organization of a page-list entry. 

Each page -list entry is associated with a channel command word (CCW) 
list entry; the CCW entry tells what operation is to be performed with 
the data buffer. A CCW entry does not need to point to a page-list 
entry; a page-list pointer of zero is assumed to mean that the lORCB 
buffer is to be used. 7ou can use any number of CCW entries as long as 
the size limit of the lORCB is not exceeded. Figure 29 illustrates the 
format of a CCf list entry. You always have at least one CCW entry, 
sincre the CCW represents the work you want the supervisor to do. 

If the software command chain flag is 1 (see Figure 30) , the supervi- 
sor continues to reissue SIO (Start I/O) instructions at the cmrrent 
point in the CCW list when a device-end interruption is received. This 
has the effect of making the CCW list appear chained, even though the 
path to the I/O device may be free for certain periods during the opera- 
tion. This command chaining terminates when all CCWs in the lOECB have 
been processed. The most common use of software command chaining is to 
use a standalone seek to position the disk arm followed by a channel 
program to read or write data. This command chaining terminates when 
all CCWs in the lOECB have been processed. 

If the lORCB chain flag is 1 (see Figure 27) , the supervisor changes 
the last CCW entry to a transfer in channel (TIC) command if another 
(second) lOCAL for the same device is received before the final channel- 
end/device-end interruption for the first lORCB is received by the su- 
pervisor. This TIC command links the CCW lists of the two lOlCBs. The 
supervisor will also set the program controlled interruption (PCI) bit 
on, in the start CCW of the second lORCB. The receipt of this PCI sig- 
nals the completion of activity for the first lORCB; the supervisor then 
queues a pending task-I/0 interruption for that lORCB. 

The lORCB received by the task monitor as a result of the task-I/0 
interruption has been changed by the supervisor; it is not identical to 
the lORCB originally received by the supervisor. Figure 30 shows the 
fields in the fixed area of the lORCB that may be set by the supervisor. 
Figure 31 shows the change^ to the CCW list entry. 
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Is part o£ Its imterirmpt-liaEdliiig logic , the task Boaltor transfers 
control to tke posting routine pointed to bj tlie lOlCB it receives as a 
by -product of the task -I/O interrnption • This posting routine informs 
the prograa originally issuing the lOCIL that the I/O operation has been 
completed. 



Word 1 Word 2 

0123456 701234567012345670123456701234567012345670123456701234567 



lOCAL (SVC 231) 



Used by access methods — not set or Interrogated by lOCAL 



Length of lORCB 
in 64-byte units 
(blocks) 



Length of page 
list in 
doublewords 



Re-ative origin 
of page !ist in 
dojblewords 



Storage 

protection key 
(1 or 2) 



Start I/O fail- 
ure count 
(Note!) 



Length of CCW 
list in 
doublewords 



Relative origin 
of CCW list in 
doublewords 



Relative origin 
of storting CCW 
in doublewords 



Length of lORCB 
data buffer in 
doublewords 



Relative origin 
of lORCB data 
buffer in 
doublewords 



I/O address to 
be used for this 
openation {Note 2) 



Not used 



System symbolic device 
address must be given if 
actual path not supplied 



Used by access methods — not set or interrogated by lOCAL 



V-type address constant of pc»ting routine to be transferred to 
by the task monitor when the task- /O interruption associated 
with this lORCB occurs 



R-type address constant of posting routine ( see preceding 
word ) 



Lfeed by access methods — may be set by lOCAL 



Used by access methods — not set or Interrogated by lOCAL 



May be set by lOCAL 



Used by access methods -- not set or checked by lOCAL 



Users' options 



Not used 



||RIC|E 

(Note 3) 



HU 



Set by lOCAL 

(Note 4) 
■ M I M I i 



Options 



Used by lOCAL for performing sense operation 



Note 1. 

Note 2. 
Note 3, 



Note 4. 



If flag R (Note 3) is one, the Start |/0 instruction is reissued the 
number of times specified by this count, or until the Start I/O 
Instruction is successful y Initiated. 

If flog S (Note 3) is ore, the l/O address contained in this halfword 

is used and the symbolic device address is ignored, 

S=specific I/O address, I = Ignore device malfunctioning indicator in 

pathfinder; R=if Start l/O not accepted because device Is busy^ 

reissue Start I/O (see Note 1); C = Software command chalni E = error retry mask; 

H= issue Halt I/O on device before start l/O; U=if unit check occurs, 

read direct access device record zero Into lORCB data buffer; P= treat PCI 

as channel end/device end. 

lORCB chaining flag; I* another lOCAL is received for this device while 
the channel program for this lORCB is rynning, the last CCW of this list 
is chained to the first CCW of the other lORCB. 



Figure 27. Format of fixed area of inpnt/ontpnt request control block 
as set before lOCII. 



Word 1 
012 3456 70123456701234567 





1 12 3 4 5 6 7 


1 2 34567 


Word 2 
0123 456701 23456701234567 


High-order 20 bits of virtual storage address; the 
segment and page number of virtual buffer page 


Flag 


Unused 


Set to main storage location used for this 

page -- before lORCB is returned to task monitor 

at task- I/O interrupt 


L..- 


A 


(Note 1) 



Note 1. A= (paging storage) copy of this page does not need to be used; use any main storage page and release paged copy 

Figure 28. Organization of a page list entrj 
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Word ! 



Word 2 



12 3 4 5 6 7 


12 3 4 567 


12 3 


45670 1234567 


1 2 3 4 5 67 


12345670 


12 3 4 567 12 34567 


CCW operation 
code 


PosiHon of page 
list entry 
1,2... 8 
{Note 1) 


Flags 


Displacement within 
page buffer or from 
start of lORCB buffer 
or from start of CCW 
list if TIC 


CCW flags 


Zeros 


Byte count 


H 

(Note 2) 



Note 1 . If this field is 0, the lORCB data buffer is assumed 

Note 2. I = do not relocate CCW addresses 



Figure 29. Channel cosBand word list entrf before lOCAI. is issued 



Word 1 Word 2 

01234567012 345670123456701234567012 34567012345670123456701234567 



Unchanged 



Unchanged 



Unchanged 



Set to actual I/O address used 
for this operation, or left 
unchanged if user supplied 



Unchanged 



Unchanged 



Unchanged 



Unchanged 



Condition Codes 

TUTTTcTcTsTs 

(Note!) 



Main storage address used for lORCB data buffer. 
If no lORCB buffer used set to end of fixed area 
in lORCB; buffer must follow fixed area. 



Unchanged 



Sense 

condition codes 
I I C C SS 

(Note 2) 



Sense CSW status placed here 
if both requested operation and 
sense operotion fail 



Sense failed fg 



Ol 
(Note 3) 



Halt I/O retry 
count 
(Note 4) 



Unchanged 



Flags 



Unchanged 



|S|P| l|liR[N!w|T!x|x|c| ' 
(Note 5) 



Not used 



CCW for performing sense operation on requested I/O device 



Note 1. If operation come to abnormal end, these condition codes are stored: l = test l/O 

condition code; -C=test channel condition code; S=start I/O or halt j/O condition 
code. 

Note 2. If sense operation failed, these condition codes are stored for i/O instructions used 
to ottempt sense (see Note I) . 

Note 3. = a device other than the one requested has monopolized the control unit; sense 
data applies to that device. 

Note 4. If user requested both a retry of start I/O and halt l/Os before each start I/O, 
this field is set equal to the user-supplied start I/O count. 

Note 5. S=CCW specification error; P=no path exists to requested device; f = start I/O 
failed; H = halt l/O failed; R = read record (on direct access error) failed; 
N = sense failed; W = CCW addresses are relocated (changed to real addr) 
T=IORCB aborted because previous (pending) lORCB for same task had abnormal 
end; x = internal flag for iOCAL; C = interrupt code applies to device other 
than one requested monopolizing control unit. 

Figure 30. Fixed area of I/O regnest control block as set by lOCIL 



012 3 4 567 


Word 1 
0123456701 23456701234567 


Word 2 
01 23456701 23456701 23456701 234567 


Unchanged 


Main storage address 
used for operation 


Unchanged 



Figure 31. Channel coaaand vord list entrf after task I/O interrnption 
occurs 
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Ixaaple : Ikenever fom use an I0CII., fou should be sure to refer to the 
current version of the lOBCB. The format of the lOlCB is described by a 
dnsmj section in the sfsteM copf/aacro library. Ion can get a copy by 
assembling a program with this instruction in it: 



C0P1 



CHIIOB 



Suppose fou want to read 120 bytes from symbolic de¥ice 85. lom might 
write: 



BGl 



TlSt 



EIDFIX 

BUF 

CCW 

101 BID 
IBID 



EX 


OBTEST 


B 


IlAI 


BS 


OB 


lOCIL 




BC 


XL6«0» 


BC 


ILIf (TlST-IOlllB) 


BC 


XL2*0» 


BC 


X»02« 


BC 


X»0» 


BC 


X*01« 


BC 


iLl((CCW-TBST)/8) 


BC 


X^O^ 


BC 


IL1 {120/8) 


BC 


iLl((BnF~TEST)/8) 



BC IL2fO) 

BC XL2«0« 

BC IL2(85) 

BC XL8«0® 

BC f (POST) 

BC H (POST) 

BC IL28«0» 

BC XL4»0« 

BC IL8«0» 

BS OB 

BC 1L120«0» 

CCf REIB,0,I»20«,120 

BS OB 

IQO 194 



EXECUTE lOCIL SVC 



SfC 231 (lOCIl) 

101 USED 

/64) LEIGTH OF lOlCB 

IW 64 -BYTE UlITS 

SO FIGE LIST 

PROTECT 101 KEl 

SIO FIILOIS COPIT 

CCi LIST LEIGTH (BOUBLBiOHDS) 

HELITI?E OEIGIf OF CCW LIST 
II BOUBLEiOBBS 
lELITIVE OBIGII OF STIITIIG 
CCf II LIST - FIEST OWE 
lOlCB BliTA BOFFEl LEMGTH II BIORDS 

HELITI¥B OBIGII OF lOlCB 
BUFFEB II BOUBLEWORBS 
10 ICTWIL iBBEESS 
lOT OSEB 

SIHBOLIC BEflCE IDBRESS 
SOT 0SEB 

V-COl OF POSTIIG BOOTIiE 
R-COl OF POSTIIG ROUTIIE 
lOT USBIl 
10 OPTICWS 
lOT OSEB 

BIB OF lOFCB FIIIB lEBI 
BIFFEE AHEI 

EMB OF lORCB 

2540 BCB EEIB COIIIIB 



lotice tbat the CCW page-list entry and displaceaeEt fields are both 
zero; tkis causes the lORCB buffer to .be used aad the information to be 
read iato 'tlie first bfte of the buffer. Ifter the opera tioa is com- 
plete, the supervisor causes a task-I/O interruption which stores the 
lOlCB in tke intermptioE storage area. The posting prograa (POST) cao, 
■o¥e the data out of lORCB boffer at that ti«e. 



ITI — Inhi b it Task Intermptioiis (01 

The ITI Macro instruction is used to prevent the occurrence of all 
■askable task interruptions fexternal, asjnchronous I/O, sfachronous 
1/0 , ti»er| ; it does this bf setting the interruption storage area lock 
bfte (ISILi:::k) to Is with the Test and Set instraction- 

I -"^ — T" ^ — ^ — " — r ^ — - — ~ — — - — ~ ^ — --— _ — .^-_,-™--__ — -.____»_^ 

I lane | Operation! Operand 1 

j ^ 1. ^ — ^_™™.4______..„™___..^ ^,_ ^ ™_„„.™_„„^„_™..„^_^ 



|[syMbol]|ITI 

I L, 



Mote: There are no operands. 
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To use ITIf you must define the sfabol ISILCK bf copfing tlie inter- 
ruption storage area dnnay section fCHIISI) from the sfstea macro/copy 
library* 

LLIST — Create Load List Eatry fOI 

LLIST geaerates an entry ia a load list. I load list is used to de~ 
temiae daring systea startup which CStCTs aod object wodnles will be 
loaded^ and in what order ^ to form TSS* LLIST can be used when creating 
the load lists (object nodules CHB?R, CHBIS, and CHBRC) that arc? fmr- 
aished as part of the systea on the IPL Toluaej, or when creating load 
lists to be included in a delta data set. I load list ia a delta data 
set will allow addition or deletion of system modules during a startup- 
to-shEtdowm session. 

LLIST can also be used to insert user-accessible (usually PL/I) 
BOiliiles into IfM (initial Firtual storage! so that they will be access^- 
ible for sharing by multiple users. 



fllane fOperation f ODerand I 

fcsect or f I | 

fffiod'jle namefLLIST f[load f lag T [fSf'locti^e load clarF i I 

I f f[ ,ROPROT=N ] ^ ' f 



f I Name | Operation | Operand ( 

I t ILLIST f BAFPIKR= [PRTYATF fSHARFD] | 



csect or aodnle naae 

specifies a control section or object module naae for which an 
entry is to be aade In the load list. It aay correspond to a con- 
trol section already on a systea load list (if this is a delta data 
set load list) or be a new control section to be inserted is to TSS 
for this startop-to-shutdowii session. Ihem user-accessible nodules 
are beimg listed, either the module Ba»e or the nane of aay CSECT 
■ay te specified; if any CSECT aane is specified, the entire module 
is iEcliided during startup. 

Specified as ; The naae of the control section or object aodule. 

load flag 

represents a load restrictioa or conditioa that amst be observed 
when loading particular CSECTs. 

Specified as ; One of the symbols designated beioi; they are shown 
with the hexadeciaal code which is entered Ie the flag byte aad the 
code meaning. 

Symbol Code fteaiiimq 

SBTXP 10 I¥R pages; SETXP is allowed in CSECT. 

USEB 20 Module accessible to both user and systea 
prograamers . 

1,0 40 R/0 control card (first aodule in reside?it super- 
visor that cannot be paged oat by fSSS) « 

PGBD 80 Bust be loaded on page boundary. 

Default. : The load flag byte is set to zero^ indicating no special 
restrictions . 
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LOAD LIST ID 


FO'JCTIOH 


01 


HJE 


02 


2250 SO^P 



TNI GN2{M106 (01 July 80) to GC28-200'8-5 

selective load class 

specifies a code that is used at startup to indicate selective 
loading. During startup, tMs code is compared to codes entered 
dynaaicallf by the operator that indicate which aodnles are not to 
be loaded into the system. If the code in a load list entry 
Batches an operator-specified code, the co^ntrol section or nodule 
indicated in that entry is not loaded. 

Specified as : h two-digit hexadecimal nusber- This may be speci- 
fied as 00 or the operand aay be omitted if the control section or 
ttodtile is always to be loaded r or any code fro^o 40 to FF« Codes 01 
to ^iF are reser¥ed for IBH system usage* 

The following codes and systea tunctions have been assigned: 

CSiBAC CSIBBC CEABCC CHBRJE 

CZCfIC C2C¥IP CZCIBC CZCVBP CZCfCC 
C2»CfCP CZCinC CZCfDP CZC¥EC CZCfSP 
CZCfFC CSCfFP CECfGC CZCYGB 

08 ASSSKBLFE CKfP^LL CEVELE CEVPIB CEfPAS CEVF11 

CS?FI2 CBfPlJ C£?PI4 CiSfPiS CE¥FI6 

CEVPA7 CE¥PA8 CEfPA9 C1¥PB1 CE¥PC1 

CS¥PD1 CSVPEl CB]¥PE2 CE¥PF1 

09 FORTRIi CmkDE CEKID2 CEKCSB CEKJAE C2KJB1 

CEKKRB CKFKHE CEKMG1 CEKHXM CIKSIE 
C^XSFI CEKTIR CEKTCM CEKDDl CEKOKM 

12 2305 SOPPOET CE&B7C CEAB8C C11B9C 

IS 2860/2870/2830 CKAH60C CMiB70C CEIH30C 
EEROK, 1EC0¥EPY 

CM A lie 



CIPIOC 



ROPHOT 

indicc^tes that the CSECT is not to have read oBly protection. 

Speciiied as : l^ 

Defaul t ; if not specified ^ page will be read only protected if 
CSECT has read only attribute « 

BA8BIER 

generates a paqe that cannot be allocated so that if any reference 
is made to this pa.qe, pro-.iram interrupt S (addressing) will occur. 
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IHfEGlIfED 






CHAKHEL 






BEEOB BBCO¥BRY 


99 




SIPE 


Def 


anj>t: 


00 



Specified as : 

PRIVAl'E - for private paaes 
SHARED ~ for shared oaqes 

Default: none. 
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CAOTIQIS : Wkea changiag tke load list, the prograaaer should be careful 
to plac» entries into the aodificatioa CSECT ±m the proper sequence 
(soiie load-list entries must appear in the CSECT before other entries) . 
For example p. the RTllI buffer pages and control blocks Bust be loaded be- 
fore other RTIM modules. 

LLIST can not be used for control section or module names that con- 
tain characters not acceptable to the TSS asseabler (for exaapler 5*, «.r 
*) ., The load list entries for these CSECT or module names must be coded' 
using DC instructions. For exaaple: 

DC CL8»^SECTMH» MODULF/CSECT M^ME 



DC 


XL1»00» 


FSSFRVED 


DC 


XL1»20» 


LOAD FLAG 


DC 


XL9»00» 


RFSFR¥ED 


DC 


XL1»40» 


SELECTI¥E LOAD CLASS 


DC 


yL1»00» 


EXTENDED LOAD FLIG 


DC 


3XL1 


SPARE 



ProaraEtainQ Hotes ; There are three system fPIft data sets that contain 
load lists: TSS*****.SYSIfM,. TSS***** .lESSUP,. and TSS***** .BSSSOP^ 
STSI¥I! contains all of the CSlCTs that are part of initial virtual 
storage (Iff!) ; BESSPP all the CSECTs that are oart of the resident su- 
pervisor ; and ISSSUP all the CSECTs that are part of the RSS support. 
Bach of these data sets has a special member (the load lxst| that con- 
tains the names of the CSECTs for the aeabers within the partitioned 
data set tnat are to be loaded into the system at startup. 

System programmers can modify these load lists by creating a new 
ioad-list CSHCT (see below) and including it as a delta data set on the 
delta data set volume that is to be processed during startup fsee System 
Generation and Haintenance ) « Delta data sets are used to dy Basically 
ttodify the system to determine the effect of changes being introduced to 
the system without permanently updating the systea. These changes 
remain in effect from startup to shutdoiin. 

During startup,, the delta data set volusie is searched for !?»,► 
lESSyPy and ESS control sections • The IPL volume is also searched for 
any remaining system CSSCTs for which no delta data set exists « Iny 
CSECT founa on the delta data set volume having the saae name as a CSZCf 
that is part of one of these systeii data sets replaces the existing 
CSECT meatber of that data set; it is loaded with the control sections 
found on the IPL volume to make up the current version of the system 
data set . 

Since a new load list actually replaces tke old ooei, all the old 
load -list entries that the user wants to have included in the neM load 
list aust be respecified in the new load-list CSECT. To aake sure all 
old entries are specified |. a programmer should create the new CSECT by 
copying the old load list and editing it to include any new entries or 
delete specific old entries. The source data sets that the programner 
Might want to copy and edit are: SOUS'CB.CHBfH for the SYSI¥H data set, 
SOORCE-CuaRC for the HESSOP data set, and • SOURCE .Cff BE S for the HSSSOP 
data set . 

Ihen creating a new load-list aodule, assigii the same CSECT and 
module name as that of the load— list module that is to be replaced* 

The LLIST macro instruction can be usei to generate entries in a 
load-list CSECT being created by system proarammers. Each 24-byte load- 
list entry contains an B-byte CSECT name, a reservei byte, a startup 
flag bytG^ nine bytes that are not used until startuo, and aselective 
loadina tyte^ as shown In Figure 32. 



160 



TNL GN20-4106 (01 July 80) to GC28-2008-5 



An LLIST macro generates this entry m a load Mst 



crnry 1 " 




CUECT or 
moduie name 



Load 
Flag 



1 1 



Figure 32. Load list entrj 



24 Bytes 
R = reserved 



~- -^ Entries 2 to n — ^ , 



Ex- 
tended 
Load 

Fiag 




\ 



Selective IcMd class byte 



ExaiEple ; i systeii programmer wants to load two aew modules into initial 
virtual storage {l^B) during startup. He aodifies SlSlfM.LOADLIST using 
the LLIST aacro. 

*** CSECT fOfi SlSIfll.LOIBLIST DELTA B&TI SET *****#***********♦**** 

CHb¥HL CSECl 

ILL ENTBIES FKOM OLD LOAD LIST 
THAT 112 TO BE IfCLOLBD IM 
THE HEi OSB 

CtiBMEBl LLIST PGBL|.^0 

The LLIST generates: 
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CHBIlll 


DC 


CL8»C1BIE11» 


CSlCf IIIE II IBl lODULl 




DC 


XL1«0» 


1BSEE¥BD 




DC 


XL1»8D» 


LO&D FLIG 




DC 


XL9«0» 


lESEBfED 




DC 


X]L1»ilO» 


SELECTIVE LOAD CLISS 



LOCPAG — Locate Page IBl 

The LOCPAG aacro sets up tke paraaeters and calls the Locate Page 
Module (CSAIL) to obtain the addresses of tke Page Table (P6T) and Ex- 
ternal Page Table (TWT) for a specified virtual aemorf address and task« 
Option allf, the page hold count for the specified page is either incre- 
mented or decremented. 

1 -^ ' 

I laae | Operation | Operand 

1 ^ ^ 

[[symbol ]| LOCPAG (virtual memory address, TSI address 
I I[,error address] [ ,BEAD={T| 11} ] 

I |[ ,H0LD={IGH01E|I1ICB|DEC1} ] 

I I . 

virtual memory address 

specifies the virtual memory address to be located 

Specified as ; A register containing the virtual memory address or 
a symbol, defined as fullword aligned, containing the virtual 
memory address* 

TSI address 

specifies the real memory address of the TSI of the owner of the 
virtual memory address. 

Specified as ; A register crontaining the TSI address or a symbol, 
defined as fullword aligned, containing the TSI address. 

error address 

specifies where to branch to if an error indication was returned by 
Locate Page (CEAHL) • 

Specified as ; A symbolic address. 

Default; The program continues at the next sequential instruction. 

BEAD= 

indicates whether or not the page table describing this virtual 
memory address is to be read into main storage if it is not cur- 
rently in main storage. 

Specd.fi ed as ; ¥ or 1. 

Default ; Y 

HOLD= 

indicates whether the page hold count for this virtual memory 
address should be ignored, incremented, or decremented. 

Specified as ; IGHOBE, IICR, or DECB 

Default ; IGIOIE. 
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Ixectttiom: Upon execntioii of tlils aacnro Instruction, paranetez: regis- 
ters are set up and the Locate Page Module (CBAIL) is called. 

Be turn Bata : 

Beaister Contents Heanincr 

psige table address 

1 external page table address 

15 no error 

<l segment not assigned 

8 F^9® i^ot assigned 

12 P2^9e table not in seaorf 

LOG? LOCR — Define VM Lock Incbor IQI 

LOGWLOCK defines a block of storage where other xxx¥LOCK nacros can 
record the status of a WE Lock* 

• 1 1 1 

IVaae | Operation {Operand I 

I 1 1 1 

Isjnbol ILOGTLOCK | I 

I I I I 

lote: The nane syiibol is regnired; there are no operands. 

Bxectttion ; fhis nacro generates a cx^ntrol block for use bj other nacros 
of the xxxfLOCK set. 

CAOTIQM ; This macro nnst appear in a PSSCT. 

Proaranninq Bote : Befer to WE Locking in Section 3. 

LfPSW — Load firtnal Program Status lord CBI 

The LVPSl macro instrucrtion alters the flow of your program bf chang- 
ing its ?PS1. 



I 1 J 

flame liberation {Operand 

I- 



If symbol ]|L?PSW |[?PS1 address] 

t I I 



fPSl address 

specifies the virtual storage address at which the new VPSl is 
presently stored. 

Specified as ; In BX address, or as register notation. 

Default s It will be assumed that the issuer has placed the address 
of the VPSW in register 1. 

Initializati on ; 1 DCLISS macro instruction with the PBIflLBGlD option 
must be coded in a CSBCT prior to coding LVPSl. If more than one DCLASS 
macro instruction is issued in a module, the last DCLISS issued prior to 
coding L?PS1 must be issued with the PBI?ILEGED option. 

Execution ; The virtual program status word whose address is specified 
becomes the current virtual program status word. The previous contents 
of the virtual program status word are lost. 
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Bxaittple : issume locatioii llifPSW contains a new virtual prograa status 
word tkat is to be loaded. lorn might write: 

H&EE L¥PS1 miVFSl 

I i&PTDY — Connects Disconnects or Bx&and the fPI (0\ 

fhe liPTDI aacro instruction transfers control to the aaptdy program 
in Initial Virtual Storage. 

p 1 -I — — — ^ . J 

I lame | Operation {Operand I 

I H ^ ^ ^ 1 

|[ symbol ] I IIPTDY |{TrO|B} | 

I ^ 1 -I ^ . I 

specifies the function to be performed bf the maptdy program. 

Spe cif ied as ; 

T - disconnect user space and connect TDY. 

- disconnect TBI and connect user space. 

E - expand fDI area. 

Executio n: fhis macro instruction places in register 1 the following 
values for the requested function : 

I request value in register 1 
T 1 

2 
E 3 

I Control is then passed via type 1 linkage to module C2CB1. Opon return 
I from C2CD1, the requested function will have been performed. 

I there is no return data. 

I Programming notes : if the TDI is already connected on a 'T* call or the 

I user space is already connected on a ■!?• call^ CZCDi Just returns to the 

I caller. If the expand TDY request •£» is specified, the TDY must be 

I connected prior to the ■£• call. 

I The disconnected segment group name for the TDY area is defined in the 

I ISA by the field ISITDYIi The flag IS&TDCM defined in the ISA is used 

I to determine if the TDY or the user space is connected; if the flag is 

r on, the TDY is connected. 

MOVGQE — Move GQE to Hew Scan Table Entry 

lOfGQE sets up the parameter list and caUs CEAJMG to move the GPE to 
a new scan table entry, or if finished, to release the GQE and certain 
attached control blocks* 

i ^ — I « ^ ^ 1 

(lame | Operation {Operand I 

I 1 1 : ^ . 1 

I [ symbol }| MOVGQE tf ^QK I 

I ^-j I ^ ^ 1 

GQE 

generalized queue entry to be moved. 
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specified as ; the address of the GQE, or the aaae of a sfBbol de- 
fined as a fiilliiord containing the address of the GQE. 

CJkOflQIlS ; The PSA dsect CHAPSA must have been copied and assigned a 
base register prior to the use of this aacro. The expansion of this 
macro is affected by the use of the CVT aacro prior to the use of this 
macro- lOfGQE assnaes that the GQl being aoved is not currently 
enqueued on the scan table. 

Prograiyiinci lotes : MOVGQE will move the GQl loc-on-gueue values to get 
the nert gueue entry. If GQBLQ is not egual to X»FFX:x«, the GQE will be 
enqueued on the corresponding entry. If GQELQ is equal to X'FPXX*^ 
II0¥GQE will release the GQE and any associated PCBs. If there are no 
PCBs, then the caller must make sure that GQBCHT is 0. 

Examples : 

(1) Register notation; CVT YES is assumed 
M0?GQE (1) 



* L 15,CVTJ»G 

* BALE 14^15 

(2) Symbolic name; CVT YES is assumed 

HOfGQB TCIGQE where TCWGQE is defined as a fullword 



♦ CHBfAL TCiGQE^I 
♦LI ^TCIGQB 

♦ L IS^CVTJMG 
4- BALI 14, 15 

13) Symbolic name; C?T 10 is assumed 
MOfGQE TCIGQE 



♦ CED¥AL TCiGQE 

+ L 1, TCIGQE 

+ L IS^PSACVT 

+ L 15,CfTJMG-CaAC?T(,15) 

+ BALfi 14,15 



EQ¥XP — Kove Page fable Entries (R) 

'fhe MO¥XP macro instruction moves page table and external page table 
entries from one table to another or from one part of a table to 
another. 



i 1 ^ 1 ^ 

I name ( Operation | Operand 

I 1 1 

|[ symbol 31 MOfXF l[old address ][, new address][ rpage count] 

I 1 1 ^ ^ — _ — . 



old address 

specifies the virtual storage address associated with the first 
page table entry or external page table entry you want aoved. 

Specified as : An RX address^ or register notation. The address 
must be a multiple of 4096. 

16i* 



Default : It *ill be assumed that the issuer has placed the Eew 
address in register 0. 

new address 

specifies the aew virtual storage address with which you want the 
first eatrf associated. 

Specified as ; la BX address ^ or register notation • The address 
must be a multiple of 4096. 

Default ; It will be assumed that the issuer has placed the old 
address in register 1. 

page count 

specifies the number of consecutive entries jou want moved. 

Specified as ; In absolute expression or register notation. 

Default: It will be assumed that the issuer has placed the page- 
count in register 15. 

Initiali zation ; I DCIISS macro instruction with the PHIVILBGID option 
must be coded in a CSBCT prior to coding 10?XP. If more than one DCLASS 
macro instruction is issued in a module, the last DCLASS issued prior to 

coding flOVXP must be issued with the PHIVILBGID option. 

Execution; fhe page table and external page table entries associated 
with the page addrc^ss specified in the first operand are now associated 
with the page address specified in the second operand. The number of 
entries to be moved is provided in the third operand. Bach old page ta- 
ble entry is marked assigned but unavailable; each old external page ta- 
ble entry is cleared to zero. 

Example ; Suppose 3rou want to move 300 pages located at IM to an area 
beginning at OCT; both IM and OUT must be page boundary addresses. lou 
might write; 

MOfl lOfXP II, OUT, 300 

iSGlR — Issue System Hessaae and Get Hesponse (SI 

Mote ; This macro has been replaced by PIMFT and must not be 
used for new code. This documentation is retained only to aid 
in the maintenance of existing programs. 
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the HSGWl aacro iEstmctioa issues a Message to SISOOf aEi^ if speci- 
fied, fetches the response and places it in a user-designated area. In 
conTersaticmal sode, STSOUT is considered to be the terminal and, in 
nonconTersational aode, STSOUt is considered to he the data set contain- 
ing system messages that will be printed at the end of the task. 
Besponses ca,n only be made in conversational mode; therefore, the 
response option may only be specified in conversational node. If the 
response option is specified in noncronversational mode, the task is 
abnormally terminated. 

HSGffR issues system messages only. The text and the message numbers 
assigned to these messages are described in System Messages . The user 
can modify a standard system message by inserting variable information 
into it. Tariable fields are filled in by HSGWl, using information sup- 
plied by the user. 

the format for the HSGll macro instruction is indicated below, fhe 
information associated with each parameter must be placed in storage by 
the programmer before issuing the macro instruction. 

Standard form: 

I I — 1 ^ ^ ^ • 1 

flame federation {Operand I 

I 1 ^ ^ ^ ^ 1 

I [ symbol] I HS Gil {message id, [variable data] | 

I I |[ ,response area, response length] | 

i 1 ^— i . 1 

L- and 1-form: 

I 1 ^-T ^ • 1 

flame (Operation {Operand f 

I ^ -I ^ ^ ^ 1 

I [ symbol ]|HS Gil ([message id ],[ variable data] ( 

( ( ([, response area, response length ], I F= p, ( (1, list) } | 

I 1 —J , ^ 1 

lote: k symbol is required in the name field of the L-form. If the 
message id operand is not specified in the L-form, it must be supplied 
in the 1-form. 

message id 

specifies the address of a fullword containing the message number, 
a response flag, and the number of variable fields to be inserted. 
This information must be inserted by the user in the fullword in 
the format described below. 

Byte Contents 
0-1 Message number - four hexadecimal digits 

2 Response flag - 1 if response is desired 

if not 

3 lumbers of variable fields to be inserted (see the 
description of the variable data operand) 

Specified as ; In the standard and L-form, as a relocatable expres- 
sion; in the E-form only, also as an 11 address. 

variable data 

specifies the address of one or more doublewords that identify the 
text to be inserted in the variable field of the message. There 
must be as many doubleword entries as are specified in byte 3 of 
the location specified by the message id operand. The first of 
these words gives the number of bytes of text, in binary. The 
second word points to the actual text. 
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Specified as ; Same as tke first operand. 

respo&se area 

specifies the address of the area into vkich the response (if any) 
is to be placed. 

Specified as : Sane as the first operand. 

response length 

is the address of a one-vord field into vhich the length of the 
response (if any) is to be placed. The response area must be large 
enough to accept the longest expected replf (128 bjtes) . If the 
response does not fit in the allotted area (because less than 128 
bftes were specified) ^ it vill be truncated, starting with the 
rightnost character. 

If the user has any donbt about the length of the response, he 
should use a 128-bfte response area. 

Specified as s Sane as the first operand. 

Initialization ; If this macro instruirtion is to be executed in a privi- 
leged nodule, the nost recently issued DCIUSS macro instruction in the 
assembly nust have specified PBIVILE6SD. llso, the address of a save 
area nust be placed in register 13 before this macro instruction is 
executed . 

Programming Motes ; legisters 2 through 12 and the floating-point regis- 
ters are unaffected by expansion of the HS61B macro instruction. 

Betum Data ; On return from HSGIB, a hexadecimal code is loaded into 
the low-order byte of register 15. The significance of these codes is 
as follows; 

Code Significance 
00 lo attention interruption; no error in response length (if 
applicable) • 

04 Besponse too long for area specified. Truncation occurred. 

08 Jlttention interruption occurred; status of response (if 
any) is unpredictable. 

Upon return from HS61B, if a response was requested, the acrtual byte 
length of the response is placed in the field specified by the response 
length operand. 

Example ; In the following example, the system message D001 is to be 
written on the terminal with a variable field containing XXUSIBID; the 
expected response should crontain a maximum of 8 characters, and the 
response is to be placed in an area called BEADIl. 

Ell HSGIB HS6CD,VABFI.]>,BE1DI1,1I.EIGTH 

In this example, the user has provided information required by the 
HSGIB macro instruction elsewhere in his program through use of DC 
innstructions • The parameters of the HSGIB macro instruirtion have been 
specified using the symbolic addresses of the DC instructions. 



HSGCD 


DC 


X»D0010101^ 


VABFLD 


DC 


F«8» 




DC 


k (TEXTtA) 


TEXTVl 


DC 


C»XX!JSEBID» 
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IBIDIi DC 2P»0« 
ILllGfH DC F«8» 

I yiB ^ — generate Mode Mentlf icatioD Bloct CSI 

Tkis Bacro iastmction is completely docuneated In the Issembler User 
Hacro Instraction MaDual^ except for several operands that are available 
only to the systems prograaaer. Only the defiaitions and specifications 
for these additional operands are given below^ but for continuity, all 

the operands are shown in the metalanguage that follows. 

I 1 — ^ 1 -~ — ^ — ^ ^ ~ ^ ' ^ 1 

laae fOperation JOperand 
l_ f. 



symbol |MIB |[llilil=resonrce name] 

t I [ ,1DB1= C {SBA=sda | EID=ttetwork address} ) ] 

I |[,USl=iiser number] [ yCP=component number] 

I |[ ,OPTI01=(PlSS,rirOOT,Drr|.EEPL,DSl,IQ) ] 

I I[ ,EXLST=address of exit list] 

I |[ ,LOGOII=address of logon parameter list] 

I |[ ,LAST1D={Y|M} ] [ rFCL=address of FCL name] 

I |[ ,lTE=address of routing table] 

f |[ ,EF={LH2#address of 1IB)| ] 



IBDfi 



SDI 



II D 



FCL 



RTE 



Specifies the address and address type assigned to the node. 

specifies the symbolic address by which TSS knows the node.. 

Specified as ; the address of a character string of 2 to 4 hexadec- 
imal characters preceded by one byte containing the length of the 
str ing . 

Bef anlt : none.. 

specifies the network address by which TSS knows the node. 

Specified as : the address of a character string of 1 to 17 
alphanumeric characters ±u the form •major node. minor node*, pre- 
ceded by a one byte field containing the length of the character 

string. 

Default ; none .. 

specifies the name of the FCL to be nsed to control the connected 
node. The OPIBST macro processor will issne a explicit LOAD macro 
instruction to load the FCL and its accompanying Format Control 
Mod nle . 

Specified as ; the address of a 1 to 3 byte name preceded by one 
byte containing its length; or register notation f2 through 12) ; or 
an KX address. 

Default; none.. 

specifies the aiddress of a routing table to be used by MMII for 
connecting to the node. The routing table is described in the 
CHASTE DSECT. The ITE operand is valid only for OPTIOS=lQy and 
will be ignored! for any other OPTIOS. 
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I specified as : register aotatioE {2 tkrough 12); or an HX address. 

I Def ault ; none- 

QCBD — Specify OS BCB DSEC1? 

flie OCBD' macro iEstmction ea.ables the issuer to gain symbolic access 
to the fields in the OS DCB. 



^ J ^ — . J ^ — 

lajie I Operation I Operand 



lOCBD I 

J — . . L- 



Mote: f here are no operands. 

Executio n: The OCBD »acro expands into a copf of the OS BCB dsect. 

FrograBiming lotes : It is nsBd in the Program Product Language Interface 
(PPLI) to analyze symbolically the OS description of the nserS request. 
It should not be used in assembling or executing OS programs under PPLI 
since it is a TSS dsect; the OS DCB/BCBB macro should be used instead. 

fhese OS macros reside in the SYSOS.IIC library which is referenced when 

using the ISM H program product. 



QPIW (ttsm — Prepare the Bata Control Block for Processing (SI 

fhe OPEH macro instruction initializes one or more data control 
blocks for processing of their associated data sets. I^his description 

is for system programmers processing MSAl data sets. 

standard form : 

I ' ^ — I ^ "^ ^ ^ ^ ^ ^ ^ ^ 1 

I II ame fOperation | Operand I 

I 1 1 ^ ^ __ ^ ^ ^ 1 

|[symbol ]|0F11I | (deb address^[ ( {IIPUTI OUTPUT} )],. ..) I 

I I 1 — . 1 

L-f orm : 

I T 1 ^ -^ 1 

IMame lOpermtionl Operand } 

I H -I — ^ — — 1 

Isymbol |0P11 |[ (deb address, [ ( {IIPUT | OUTPUT} ) ],««-r) ]HF=L | 

I I ^ — I ^ ^ ^ ^ 1 

Mote: k symbol is required in the name field. Iny operands omitted 
must be specified in the 1-form. 

E-f orm : 



• -1 ^ 1 — ^ -~ — ~*^ "^ ^ ' — ^ ~ 

IMame fOperation [Operand 

I 1 1 ^ ^ ^ 

|[symbol]|OPll |[ (deb address, [ ( piPUT | OUTPUT} ) ],...) 1F= (Enlist) 



lote : If 1-form operands are specified, they will overlay corresponding 
operands specified in the L-form. The list operand must specify the 

symbol in the name field of the I, -form; or the symbol may be loaded into 

register 1 and the list operand specified as (1) . 

deb address 

specifies the address of the data control block to be initialized. 
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specified as ; Ie tlie staadari and L~fora^ a relocatable expres- 
sioa; ia the staadard aad E-forji^ register aotatioa (2 throagh 12) ; 
ia the S-fora oalj^ also as aa IX address. If register aotatioa is 
used, the address smst first be loaded iato the specified register. 

IIPUTIOIITFIIT 

specifies whether the associated data set is for iapat or oatpat. 

Specified as ; IIPOT or OOtFlIT (see the prograaaiag aotes) . 

Default ; liPUT 

ClOTIOl; The followiag errors caase the resalts iadicated: 

I ' ^ ■ — I ^ 1 

I Error I Be salt 



lOpeaiag data coatrol block that is already opea. IHo actioa. 

t I 

(Speciff iag address of iairalid^data coatrol block. |Task teraiaated. 

I i 

lOpeaiag data coatrol block nhea BDMAMl has aot beea |fask teraiaated. 
I provided. I 

t I 

tOpeaiag data coatrol block whea correspoadiag DDBF I Task teraiaated 

(aacro iastructioa or coaaaad has aot beea provided. | (proaptiag will 

I I be givea if 

I I task is coBver- 

f jsational) . 

I I 

iOpeaiag data coatrol block coataiaiag iavalid BSOHG ITask teraiaated. 
I specif icatioa. I 

I i . . , I -_- I 

Prograaa iacf Motes ; loa aay specify aay aaaber of data coatrol block ad- 
dresses aad associated opticas ia the OPEH macro iastractioa. This fa- 
cility allows parallel opeaiag of data sets. 

OFIM iaitializes all the fields ia the ISIH portioa of the DCB^ as 
well as obtaias all the pages aecessary for ESkB operatioas. 

If the DCB COMBIMl flag is set^ the reader is assaaed to be oa the 
saae 254 fraae as the paach, aad the symbolic device address of the 
reader mast be oae greater thaa that of the paach. 

A violatioa of aay of the followiag restrictioas caases the OPSI 
aacro iastractioa to abaoraally teraiaate the task. 

• The DCB MJkCRF field aast specify oaly that GET or PUT aacro iastruc- 
tioa s will be issaed. 

• The BCB DBVD field aast specify (possibly froa the DDEF coaaaad) a 
card reader, card paach, or priater, aad this device aast correspoad 
to the device specified ia the BDIF coaaaad. 

• If the device is a card reader, the data set aast be opeaed for 
iapat. 

• If the device is a card paach or priater, the data set aast be 
opeaed for oatpat. 

• The DCB IBCFH field aast iadicate fixed-f oraat records or variable- 
foraat records; k/E coatrol characters aay also be specified. 

• The DCB DEVD aast specify the card paach if the DCB COMBINE flag is 

set. 
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OPEILOCK — Reset a Resident Supervisor Lock 3vte fOI 

The OPEMLOCE Macro instruction resets to X«0O» a bfte set on as tke 
result of a SEfLOCK macro instrucrtion Csee the SWSLOCK macro 
instruction) • 



I J , — I . 

I If aiie t Operation | Operand 

I 1 —4 ^ ■ 

I [ symbol ]| OPEHLOCl |lockbyter»odule IB, error numberf , {LOGI lOLOG) ] 



lockbf te 

specifies tbe byte tbat is to be reset* 

Specified as : 1 symbolic address* 

module ID 

is included for compatibility witb tbe macro definition and has no 
function. 

Specified as ; A two-digit decimal number* 

error number 

is included for compatibility with the macro definition and has no 
function. 

Specified as ; I two-digit decimal number. 

LOGIIOLOG 

specifies whether the address of the OPEILOCK macro instrucrtion is 
to be entered in the logging field associated with the lock byte. 

Specified as ; LOG or lOLOG 

Default ; 10 LOG 

OPMfLOCK — Open fl Lock fOI 

OPlfLOCK is used to open a ¥11 Lock previously set by SITVLOCK. 



• 1 ' — I ^ 

I lame | Operation | Operand 



I [ symbol ]| OPIVLOCI | log [ ,OFEl=open ] 

I 1 ^ — I ^ 



log 

specifies the VB Lock to be opened. 

Specified as ; the symbol naming a LOGVLOCK macro. 

open 

specifies an address in the current module to be branched to if the 
specified lock is already marked "open**. 

Specified as ; an RX address. 

Default ; The status of the lock will not be cheched. 

Execution ; If the branch address is specified and if the WE Lock Anchor 
indicates ••open", the branch will be performed. Otherwise, the indi- 
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cated IH Lock will be opened and the fl Lock Count (ISITLKCf) in the 
task's Interrupt Storage Area (CHAISA) will be decremented. 

CAPTIOU S This aacro must be protected from task interrupts by Ifl/PTI. 

Proqramning llote : Refer to VH Locking in Section 3. 

PCSVC — Enter Proaraa Control System COI 

The PCS?C macro instruction assembles a constant hexadecimal machine 
instruction that is intended to be implanted in a user^s nonprivileged 
code. 

• 1 • I 

{Name (Operation | Operand | 

I , 1 1 

|[symbol]|PCS¥C I | 

I 1 1 1 

Mote : There are no operands. 

Initialization ; A DCLASS macro instruction with the PBIflLEGlB option 
must be coded in a module prior to coding FCS?C. If more than one 
DCLASS macro instruction is issued in a module, the last BCLASS issued 
prior to coding FCSVC must be issued with the PRIVILEGED option. 

CAPTIOH ; The SVC 125 generated by PCSVC can onlf be executed in non-^ 
privilege code. 

Execution: A task-SVC interruption is created to transfer control to 
the task monitor. The task monitor then transfers control to the pro- 
gram control system (PCS) . This SVC is used by PCS to replace user in- 
structions in response to the AT command (see Command System User's 
Guided . 

Example : suppose you want to plant a transfer of control; you might 
code: 

MOVE IVC 1A1E(2) ^PLAMT 

B AWAY 
PLAIT PCSVC 

Programming Motes : Although the PCSVC macro instruction must be 
assembled in a CSECT in which a DCLASS PRIVILEGED macro instruction has 
been previously issued, PCSVC cannot be executed in a privileged CSECT. 
It must be executed in nonprivileged code; it is usually implanted in 
nonprivileged code by first assembling it in privileged code and then 
moving its assembled hexadecimal machine instruction into the nonprivi- 
leged code. 



PGQPT — Write Virtual Storage Pages to External Storage 

The PGOUT macro instruction enables you to write from one to eight 
virtual storage pages to one or more external storage devices. 



IMame (Operation (Operand 

I ^ 1 ^ 1^^ 



([symbol ]|PGOOT ( 

I 1 L- 



Mote : There are no operands, 
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Initializai.ion : I BCLASS macro instruetion withi the PSI¥ILEG"BD option 
sust be cocled in a nodiiJ.e prior to coding PGOUT. If aore tkan oEe 
DCLISS aac2*o instruction is issaed in a aodnle^ the last DCLISS issued 
prior to coding PGOUT nust be issued with the ?1I¥IL1GED option* 

The PGOliT aacro instrtictioii aust be the subject of an Execute in- 
strmction c.nd aast occupf the high-order halfword of the first word of a 
parameter ]„ist called an I/O paging control block (lOPCB) . The lOPCB 
consists oJ' a header and a nmaber of external storage list entries (see 
Figure 33) . 

Execution : The resident superwisor reads into storage any pages in. the 
list that exen*t already ±n main storage; when all pages are in, the su- 
pervisor widtes thea out at the external storage locations supplied in 
the exterEc.l storage list. Froa oue to eight consecutive virtual 
storage paces Ray be transMitted; the destination external storage loca- 
tioas need not be consecutive and nay be on different deYices. 

leturn data . i Before returning, the resident supervisor puts information 
in registei- to describe the action with each page in the external 
storage lif;t» Four bits of register are assigned to each page; bits 
0-3 for th€' first page, bits ft~7 for the second, etc. The four bits are 
interpreted, as follows: 

Heaninq 
lo error - page transmitted 
Virtual storage page not assigned to task 
Bequest for zero pages 
Symbolic device not assigned to task 
Page in — bad device — voluae is Rovable 
Page in ■-- bad device — voluiie is fixed 
Page in — aedium failure 

Page out — bad device -- voluae is movable 
Page out -~ bad device -- volume is fixed 
Page out ~~ »ediua failure 

Suppose you want to write virtual storage page RSLTS on the 
127th page position of symbolic device 3^. You might write: 

OUT EX 0,10fE 

H0¥1 

1 PAGE TO BE TFAISMITTED 
flETOIL MEWOEl ADDIESS 
SfWBOLIC DEVICE MOMBER 
RELATIVE PAGE BOiBEB 



Falye 


oooc 


0011 


010C 


0101 


011G 


0111 


100C 


1001 


101C 


1011 


Example: 5u 



B 


SOMEPLACE 


PGOOf 




DC 


H»1* 


DC 


If RSLTS) 


DC 


H*3<l» 


DC 


H»127» 



1 
1 


Foraat of I/O Paging Control Block Header | 


1 

1 

1 


ealfWocd 1 i 

„ .._ . . ..„ ._ „ „...._. ....^_... _ _._._. , j_ __..,. 


HaifMord 2 1 


1 

1 

1 


PGOUT — S?C 242 1 


lumber of ESL entries I 


1 

1 


Virtual storage address of first 


of 1-8 pages to be transmitted | 




f 

1 


Format of External Storage List 


Entry (F'aximua of Eight) f 


1 
t 
1 


Two Bytes | 

„.. , „ , _ „ , i 


Two Bytes f 


f 

1 — 


System symbolic device number f 


Relative page number f 

., ...J 



Figure 3 3. I/O paging control blocfc 
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TNL GN2(M106 (01 July 80) to GC28-2008-5 

im — :PriDt a Data Set ISI 

This Macro instruction is coapletely docmneiited in tlie AsseEpJer Oser 
Wacro Iiistraction maEuai, except for oae operand tliat is a¥ailable only 

to a systems prograaaer. The iefin^itioa aai specification for onlj that 
one operand are given below, but for continuity , the netalanguage foraat 
that folloMs shows all the operands. 

Standard form (see 'operand strings • in Part 2, Section 1») 



I Name 



Operation fOperand 



[ symbol ] 



PR 



{address of ooerand string 
f •DSNI?!E=data set name 
,START?IO=starting position 1 
,END*IO=ending Dosition ] 
,PPTSP={EDIT| 1| 2f 3} 

[,HEADER=H] [ ,LI!IES=lines per page] [,PAGE=P]} 
pEfASE={Y|!l| ] [ ,ERROPT={ACCEPTfSFIPfE!fD| ] 
,F0E3=standard default region namel 
,STATI05l=station id] 
,TAPO^T={AC| ADf ABfEDf EC] ] 
,CHAFS=([GS1 ] r rGS2] [ ,GS3] [ ,GSHJ) ] 
pFCB=fcfc name] [ ,PAPER=paper type] 
,COPIES= (nnn[ , (GP , . ..)])] 
,FLASH= (overlay na!!ie[ , COUNT]) ] 
,SYSUCS=iisers sysucs dsname] [ ^BURST= [I | ?J} ] 
^COPYKOD^coDy modification data set name] 

/rRC=CY|N} ]} 

,!IPRIORTY=transmission priority] 
,NETACCT=network account nniiber] 

,DEIIVEH= ([ prgmrnam ][ ,room ][ ^dept ][ ^bldcr ]) ] 
,PRTCLASS=printing ootput class] 
,I!fDEX=indexing offset] 
,^SXTWTR=external writer name] 
,I!ODTRC=table reference character]'} 



17: 
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L-form (se€ "Ooerand Strincrs" in Part II, Feet. ion 1) : 



r — - — i 1 

fName fCperation 
I i 


Operand | 


t f 1 

f symbol |PR | 


(address o"^ onerand strinq | 




f •DSllAME^iata, set name f 




[ ,STARTN0^st3rtiria position] f 




[ ,EMD!IO=endina position] | 




C^PPTSP=(^DI'^M 1 1 2 1 31 1 




f[ ^rIEADER = Hl f ^I^I^FS-linef' per oaqe] [,PAG?=P]} f 




r ,EBKSE^iYVU 1 [ ,EPPOPT= {;iCCEPT|SKIPf EIJD] 1 f 




[ rFORM = staniard default rciaion namel f 




[ ,STATia.1 = station id] f 




[ ^T^APOPT^-^ (act ^i\Df AEf EDfECI 1 f 




[ ,ChARS=CrGSl 1 [,G32] r,G!53] [,GSa])] | 




[ ^FC3 = fcb name] ( ,?h?T"B = D<iDer tvoe ] | 




[,COPIES=fiinnr , (GP,...) ]) ] 1 




[ ^FLASH= (overlay nanie[ ^COI^NT]) ] | 




r [ ,SYSUCS = users sysiics dsnaie] [ ,3U^3T= {Y f ^1 ] | 




[ ^COPY!!OD=coDv modification data set name] | 




[,THC=fYfX} ]] 1 




f [ , MPRIORTY=transmission crioritv] f 




[ ^NETACCT^network account number] f 




[ .DELIVER^ {[ pramrnam ][ ,rooi ][ ,dept ][ ,^bldg ]) ] f 




[ ,?RTCLRSS = orint ing output-, class] f 




[ ^IMDEY = indexina offsc-t] f 




[ ,EXTKTR~external writer name] | 


f 1 


r [ ^f'ODTRC-^table ref.^rertce <:h aracter ] •} f 




,MF=L f 



Note: A symbol is required in the naie field of the L--form. 



B~f orm 



I T' ^ — r' —' — ^ — ■ 

I Same | Operation |0 per and 
I ^. ^ _^ 



|[sf abol ]f ; 

I — I- 



•R 



|.^.F= (Enlist) 



{See 'Sxtettded PEIIT Coimand Facilities* in Part 1, Section ^ for a 
description aad specification ot the TIPOPT operand*) 



PRESEMf — Present Current Schedule Level im 

Tka PHESjSNT macro instruction eiiabIeF,> a task to find out its current 
schedule table entry (STE) le¥el. 



I — ^ iP_- «_ — _,| ___ — _ 

INaae fOperation lOperand 

I ^. ^ 1.™__ ^ 

|[syabol ]|i?E2S£Ml* | 

Mote: Tkera are no operands. 
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Exectttio p: Tke PIESMIT »acro iastruction generates a CH&SGE SfC C^^C 
227) specitying a schedule le¥el greater than the scheduie table liait. 
•fhe SfC executed bf CHmIGE causes an interruption. When the resident 
supervisor receives the interruption, it ejiamines the specified change 
level to determine if it is greater than 255. It it is, no change to 
the current level ir made; instead, the current schedule level for the 
task is returned in register 1S« 

keturn Data ; Bits 8- IS of register 15 contain the currett schedule ta- 
ble level*. Ill other bits rhould be ignored. 

Example : fo detemine the current schedule level of a task, write: 

lABI FEESFST 

FTl ' — Perait fask Interruptions CO! 

The PTI aacro instruction cancels the effect of an ITI aacxo instruc- 
tion; it allows pending task interruptions to occur (11 the tesk-aask 
bits in the VPSt are Is) . 



I 1 — ^ -~T ~ 

I Same | Operation | Operand 
I 1 —^ _ 

|[sYMkol JfPTl f 

I i .— - — — — ... — i--.^ -_ 



Sote ; fhere are no operands. 

FOLSE — ■ Pulse Schedule Table Kntrv level 10) 

The pyiSl macro instruction changes a task^s schedule level to a pre- 
set pulse level that is associated with its current level entry. 



I — 1 — — — ^ -i — — 

IMaae fOperation fOperand 

I- — f— 4_^™_ 

|[syKbol 3IPULSB | 

t . -J . - - I-.—. — — — - 



Mote : There are no operands « 

Execution: Ihen the resident supervisor receives the SfC interruption 
generated bf this macro instruction,, it changes the task's schedule lev- 
el to that specified in the current schedule level •s pulse field. If 
the pulse field contains a schedule level that is invalid (that is, out- 
side the schedule table liaits, or zero) r it is replaced with the cur- 
rent level, and a minor SISEl is issued. Begister 15 contains an error 
indicator upon return froi SfC 2.26. 

Beturn Data : The format of the return information in register 15 ap- 
pears as folloiis : 



112.2 



I 1 1 I 1 1 II i — I — r* 



iiiiniii 

iiiiinii I 

liiiiiiii I 
I i I III 1 1 1 — I 



r I 



rilMIMMIIIIMI 

Old 1 1 1 1 1 1 If M 1 1 r 1 1 1 f 

level 1 1 I M ri M I M I I ir i 

1 I. i I i I I I i I i i i I i I I 



lev 
level 







6 7 8 



15 16 



23 24 



31 



faliditf 
bfte 

falidity bjte value: 



Ilvafs 
returned 



Setting 
All zeros 

Bit 6 (on) 



Bit 7 (on) 



Meaning 

Tlie nev pulse level is valid* 

The pnlse level was outside the lisits of the schedule 
table . 

Zero pulse level was specified; no change of levels 
occurred . 



Example ; Suppose four task is about to perform a fnncrtion that requires 
longer though less fregment time slices, and that the pulse field asso- 
ciated with your current schedule level has been set to acxrommodate four 
special need. ¥ou may issue the following macro instruction to change 
to the desired pulse level: 



BUD 



PULSE 



PURGE — Purge I/O Operations IBI 

the PURGE macro instruction suppresses I/O devices and/or removes 
them from your task^s symbolic device list. 



I 1 —I 

I lame | Operation | Operand 

1 -h 



I 

I [symbol] I PURGE 



i {action[ ^device number}) , (task[ ,taskid]) 



action 

specifies the purging action you want. 

Specified as s One of the codes defined below. If SL, SB, SR, or 
SS is specified, the device number must be specified. 

IR - Purge all devices immediately, removing the TSBL entries. 

IL - Purge all devices immediately, leaving the TSBL alone. 

AD - for all devices, remove the TSDt only. 

IS - Purge all devices, letting active devices guiesce. 

SI - Purge single deviire immediately, leaving fSDI, alone. 

SD - Remove TSDL for single device. 

SR - Purge device specified in parameter 2 immediately, removing 
the TSDL entry. 

SS - Purge device specified in parameter 2, letting the device 
guiesce if active. 
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Defanl-t ; It is assumed that register kas been loai.ecl with the 
action code in bftes and %, and the syabolic device address in 
bftes 2 and 3. If the pre-loaded action code is »Ix*,» the SDI nnst 
be 0. 

device ninber 

specifies the sfmbolic device address of the device to be purged. 
The device nnnber anst be specified for action codes SL, SD, Sl^ or 

Specified as ; a nu»ber or absolute expression specif fing the 
register (2 through 12J which contains the SBl. 



task 



Default : see "action". 

specifies whether the purge is for all tasks or a particular task. 
Specified as ; 

IT - for all tasks 

ST - onlf for a particular task 

If SI is specified, the taskid Bust be specified. 

Default ; It is assuaed that register 1 has been joaded with the 
task code in bytes and 1, and the taskid in bytes 2 and 3. If 
the pre-loaded action code is ^kx^ , the TISKID must be 0. 

taskid 

specifies a task ID for which the purge is to be effecrtive. 

Specified as : a number or absolute expression specifying the 
register (2 through 12) which contains the TASKID. 

Default ; see "task". 

Execution : The I/O devices to be purged are suppressed and/or removed 
from the task symbolic device list (TSDI) of the task or tasks to which 
the purge is to apply. If a device is to be allowed to guiesce, its 
task symbolic device list entry is merely suppressed; if a device is to 
be purged immediately, its task symbolic device list entry is removed 
from the task symbolic device list. The TSDLs to be used depend on 
whether one or all tasks are to have their I/O devices purged. 

Bet urn Data ; legister contains an error flag, if applicable. Depend- 
ing on the reguest, this bit can have these interpretations: 

For one device, one task — device not assigned to task. 

For all devices, one task — no task symbolic device list exists. 

For all tasks, one or all devices — devices not assigned to any 
task. 

If a task that does not have the system operator privilege issues 
PDIGE for all devices and all tasks, a system error code of 6101 is 
generated . 

Example ; Suppose you wish to purge the I/O device assigned symbolic 
device number 357 for any tasks that might be using it, but you are 
willing to wait for the device to guiesce. You might write: 
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Il 2 ^=¥(357) 
PUl POIGI SS^ (2)^ IT 



gUg fMSIMI — Put a Recora fR! 

Tlie PUT Bmcro instruction may be specified in either the locate mode 
or the Bove sode. then yon specify the aacro instrnction in the locate 
node, POT returns, in register 1, the address vithin an ontpnt buffer of 
an area large enough to contain an omtpmt record; yon should then con* 
strncrt, at that address, the next segnential logical record of the ont- 
pnt data set. When yon specify the nacro instruction in the move node, 
PUT BOTes the next segnential logical record of the output data set fron 
the lociation you have specd^fied into an output buffer. 



P J 1 

I Vane | Operation | Operand 

I 1 1 

|[synbol]|PUT |dcb add res s[ , area] 

I I , I ^ ^ 



deb address 

specifies the address of the data control block opened for the data 
set being processed. 

Specified as : An RI addr^s, or register notation (1 through 12) • 
Execution tine is saved if register 1 is specified. If register 
notation is used, the address nust first be loaded into the speci- 
fied register. 

area 

specifies the address of the next logical record to be noved into 
the output buffer. This operand is used only vhen the nacro in- 
struction is specified in the nove node. 

Specified as r In RX address, or register notation {0 or 2 through 
12) . Execution tine is saved if register is specified. If 
register notation is used, the address nust first be loaded into 
the specified register. 

CAUTIOB ; If any field of the DCB is altered by an improper source, the 
task nay be abnormally terminated when a PUT macro instruction is 
executed . 

Execution : Upon completion of the PUT macro instruction, a code indi- 
cating the manner in which the instruction was completed is returned in 
register 15. The codes and their meanings are given in Figure 3<l. 
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1 ^ ^ ^ — 

lettirn | 

Code I leaning 



I Operation completed successfully, 
+ 



I I/O not complete; the record has not been accepted, since 
(there is no room remaining in the present buffer and the next 
Iseguential buffer has not fet been released from the previous 
I I/O request • The PUT macro instruction should be reissued* 
I (See the discussion of "Interruption Entrj Handling.") 
+ 



8 I Onrecoverable I/O error occurred, and the record was not 

{accepted. Register 1 points to the record on which the I/O 
I error occurred — in the case of an equipment check on the 
I card punch, register 1 points to the record immediatelf fol- 
I lowing that on which the error occurred — and register 
I points to associated BECB. FIMISH and/or CLOSS macro instruc- 
jtions may be issued. However, if the I/O error is not perma- 
Inent (D1B1F2 or DlCGl not on), you may continue processing 
[records beyond the one that failed by reissuing the PUT. 
I I . . . « 

Figure 34. Return codes for HS&l POT macro instruction 



Programming lotes : The length of the logical record is determined by 
the value of the IRICL field of the data control block for fixed-length 
(format-F) records and by the value of the control bytes for variable- 
length (format -V) records. If you write format-? records, the value of 
the LRICI field must be set equal to the maximum len<gth of the logical 
record prior to the locate-mode PUT macro instructiok. The value may be 
changed between executions of the PUT macro instruction and will be used 
to determine when to truncate the present buffer. T^he control program 
uses the current value of the LRECL field to determine the amount of 
buffer space needed for the record, even though the actual -^length is de- 
termined by the control byte built by the user in the buffer area after 
the completion of the locate-mode PUT macro instruction. 

If you do not specify FORTRJLl (ISA) or machine code in the RECFl 
field of the data cx>ntrol block, the PRTSP and STICK fieldl of the DCB 
are used to control line spacing and stacker selection, respectively. 

Printer : The MODE field of the data control block is not referred to 
for the printer. The IRECl field of the data control block must be set 
to a value not exceeding 133 bytes for format-F records, and 137 bytes 
for format-T records. These values are 132 bytes and 136 bytes, respec- 
tively, if the FORTllH or machine code was not specified in the RECFM 
field of the data control block. If you use control characters fl or i) 
for carriage control, channel 12 is ignored (greater efficiency is 
achieved by not having a channel 12 punched on the carriage control 
tape) . However, if you do not use control characters and channel 12 is 
sensed, an immediate eject to channel 1 is performed. 

Card Punch ; For format-F records, you must set the I.1ECL field of the 
data control block to a value not exceeding 81 bytes for EBCDIC, and 161 
bytes for column binary. These values are 80 bytes and 160 bytes, 
respectively, if the FOITIIH or machine code was not specified in the 
RECFl field of the data control block. For format-V records, you must 
set (for locate mode only) the LRECl field to a value not exceeding 85 
bytes for EBCDIC or 165 bytes for column binary; these values are 84 and 
164 bytes, respectively, if the FORTRll or machine code was not speczi- 
fied in the RECFH field. The HODE field of the data control block must 
contain a binary for EBCDIC or a binary 1 for column binary. 
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Exaaple : la tke following example ^ wliicli illustrates tlie use of both 
the locate-«o€e ani Move-moie PUT Bacro last met ions, yon want to print 
a file of 132-bfte EBCDIC records. Ifter each line is printei, one line 
is spac»d» Since the return codes proviiei by the aacro instruction are 

Multiples of ^^ it is possible for fou to set up a branch table to pro- 
vide proper control of processing* 



JBl 



BCB DS01G=lS^MICtP=Pp BIIID BCB 

DDlliB=TODD,DEfD=FI, 
P1TSP=1 ,.1ECF1=F,L11CL=132 

OPBI (JHL, {OUTPUT)) OPEl DCB 



lOfE 



lOCITE 



won 



LA 


a^lCTIBLl 


LI 


lyJHL 


PUT 


(1) ,1011 


L 


5,0f15,3) 


3R 


5 


LI 


1,JHL 


PUT 


<1) 


L 


5,0(15,3) 


3R 


5 


f¥C 


0(132,1), 



SET UP BIIICH TIBLE 
LOID IDDl OF DCB 
HOVB-IODE PUT HICHO 
BIIICH 01 IC IIDBI ISU 
ICTIBLE IS BISE 

LOCITB-IOUE PUT lAClO 
BIIICI 01 HC IWDEX IID 
ICTIBLE IS BISE 



lOBK 


BS 


CL132 


ICTIBLE 


BC 


I (lOBi) 




BC 


I (PIUSE) 




BC 


I (Ell 01) 



OUTPUT lEBI POl HOVE- 

lOUE PUT IICIO 

IDDH FOB PEOCBSSIIG 

IFTEl IC OF 

lUUE FOB FIOCBSSIIG 

IFTEl HC OF ft 

IDUH FOB PIOCESSIIG 

IFTBB IC OF 8 



Both the ttove-»ole and lo^ite-aode PUT macro instructions result in a 
tfpe-1 linkage to the DOHSIR routine. 



Q6QE — Qne'ie Interrmpt on Task 

QGQE sets np a parameter list ani calls CEIIF to queue the given 6QE 
(containing the task interrnpt inforaation) on a task in interrupt 
priority se<|tience . 



I Name | Operation | Operand 

I __4_..^ — _«_4. 



|[sy«bol]|Qi;QE 



fGQE [ ,I1T1PT=] 



GQE 

generalized gnene entry to be gnened on the task. 

Specif :.ed as ; a system address ^ or a symbol defined on a fall word 
bomndary that contains the address^ of the GQE to be gnened on the 
task. 

IHT1PT= 

type of interrupt to be gmened. 
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TNL GN20^106 (01 J«iy 80) to GClB^imns 

Specilied. as : a keyword, or register noxalion where the register 
contains the code for tke deEired intc-rrupt type. Acceptable codes 
and keywords are as follows: 

EeYvord IIlte r ^!lp^ Typ e uod e 

PEOG program ckeck (0| 

PAGIMG paging error (1) 

Kl'I external |2| 

ASIMC/ITT^ asjnciiroaoiis {3} 

lIFxER timer (^4) 

SYHC/SIIICO ETBctiroiioiis fS) 

VSS fSS (6| 

C AUTIOKS : 

(1) i*lie PSI dsect CMIPSI mist kave been copied by the aodiile O-t.iiig this 
macro. 

{2) The expattsioB of this iiacro is affected hj the use of the CVT aacro 
priox to the use ot this macro. 

Froqraiiiriq Motes : 

|1) QGyB assiiffies that the GQE contains tii€^ address of the task wftich is 
the recepient of the interrupt {GQTTSl} . 

f2) QGQE also assumes that the receiving task has LeeB locked by the 
calling ac^iile. 

f3) QGQE does ao ¥aliditf checking to aake sure the GQ2 contains all the 
necessary iBterrttpt inf omation regiiired for the specified interrupt 
tf pe. 

Exaaple ; To qiieme a sfachroaoa5> I/O interrupt on a task, code; 

L E3,GQ1TSI 

31TL0CK 1^SlLOCE,12^ai^LOMG,^L0G lock the task 

QGQE pi) ,IfflPT=Sf3CI0 gneae the iEtermpt 

OFEILOCK fSII.OCK,,.,LOG then,, UBlock the task 



I OSfC — Hanipulate Resource Queue . Entries SVC 

I The QSfC macro instruction, with it.^: oarameters set in registers 0, 

I 1,. 14, and 15, adds and deletes resource access entries from the 

f supervisor resource access table. 



r—— -T — — — — r — • — ^— — 

f fName fOperation lOperand 
I |.__„™^ — .+^.^_ ^^ — __^ 

i f symbol |QS?C f 



I This macro instructioR expect.s reaisters 0^ 1, lU^ and 15 to be set 
f up as follows: 
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for E !^Q 



' 


1 - d: 


V 




! 


J t V p e 


xr 1 


a a 


i A 


- ECE 






i 1 

1 
1 


- ALL 







register 0: byte C 

bit i:^Q/Tj?.0 flaa 

- •:^»ir) 

bit 1 lock tyoe flag 

- re a-! lock 

1 - write lock 

bit 2 resource controller 

- system control 

1 - 'jser control 

bit 3 VMAD^^R SDecifie-i flaa for ?riO and DEQ 

- reqisters 14 and 15 contain NAF^E 

1 - register 14 cont-iins a \f1 address; 15=0 

bit t. ICIMED/INFII^ITE flaa '• task to be piiraed 

0- infinite wait i 0- iscuina task 
1 - irpmed } 1-taskidinreg1 

bit f resource owner flaa for ENO and DEO 

- £;ystem 

1 - n s e r 

byte 1 lock wait ^-/alue i ^~- 

00 - I1!1ED/INF.INITE | — 

1 - S^fORT \ --- 

02 - rEDI'Jf ' --- 

03 - LOMG I *~- 

bytes 2-3 resc'arved 

register 1 SC3 address or taskid 

registers 14-15 resource 2IAME or address 

Eeturn cod es: the following codes are returned in register 15 by the 
QS?C processor module: 

Code >^e anina for EMQ Peaning for DEQ 

resource successfully accessed DEQ .successfully completed 

4 resource in use; request not used 

queued except for IJ11ED 

8 error in oarameters error in Daraifeters 

Note: for code 8 for both ENQ and DE() an error promot messaae 
is in register 1. 

Proaramm ina note : a QSVC for an T^HQ IHKEL rec-uest that cannot be 
satisfied will return the taskid of the task holding the resource in 
register 1. 



HCALL — Call Apother Supervisor Ao utxiie 

mCILL sets up the linkages for cailiEg another soi>er¥isor routine. 
tCALL loadi> Hegister 15 with the address of th^ entry point and does a 
hkLM 14,15.. Tae address is obtained froai the C¥T entry for the entry 
point. 
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I ^ 1 i ^ ^ "^ ■ 1 

|Mase J Operation I Operand | 

I ^.-i— 1 ^ ^ ^ ^ 1 

ICsyabol jIHCALL |EPT= | 

I i . — I . — _ 1 

EPk= 

naae of tlie entry point of the rotitine to be called. The name must 
be in tlie CfT; otherwise, an asseablf error will occur. 

CAOflOfS : 

(1) Ihe MSk dsect CillPSI atist be copied ia the assembly of the modmle 
tising this macro. 

(2) The expansion of this laacro is affected by the use of the C?T aacro 

prior tO' the use of this aacro- 

Exaiiple : To call C2ITA1, code: 
BCALL EPT=CEI1A1 
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BDI — Reset^ Drna/I>isk Interlock fQ> 

Two lockbftes exist in tlie SYSTEM table to prevent interference be- 
tween tke supervisor and tasks when llEP re€»>rcls are read. One prevents 
supervisor to task interference ^ the second prevents task to task inter- 
ference. The EDI iiacro resets the task to task lockbjte. 

^ J -J . J 

I lame | Operation | Operand I 

h- 1 -I ^ ■ 1 

|[sjBbol]|RDI I I 

I I J 1 

Mote ; There are no operands. 

Execution : The task ID of the caller is matched against that of the 
interlock and the FSl €:ondition €x>de C<^ontained in the XTSI) is set to 
one of the following: 

The interlock is cleared. 

1 The interlock was not cleared because the task ID of the issu- 
ing program did not match that of the TT interlock. 

2 The interlock was not found set. 

HECRDSTE — Becxird Schedule Table Level Changes fOI 

The ISCSDSTE macro instruction records in a table (increments a coun- 
ter) y the movement of tasks from one schedule table level to another. 
This macro also maintains a list of the last 16 schedule table levels a 
task has been using in the task status index (TSI) . 

, 1 .^ ^ . J 

I Same | Operation | Operand | 

I 1 -I ^ 1 

|[sfmbol ]|lECSDSTfi (base register, level register , work register, code | 

I 1 Jt I 

base register 

specifies a register to be used as the base for the schedule table 
level change table. 

SpeidLfied as : an absolute expression from 1 to 15. 

level register 

specifies the register that c:ontains the new schedule table level. 

Specified as : an absolute expression from to 15. 

work register 

specifies a register to be used as a work register. 

Specified as : an absolute expression from 1 to 15. 

code 

specifies the tjpe of schedule table level change to be recorded. 

Specified as : Code Meaning Module 

STIKZI TISK II DBLlf (TSEID) CEIKZ 

STXKZ2 TISK lOT 11 DELAY (TSEID) CE&KZ 

STXK23 FIEE VH LOCK C^^SEID) CEAKZ 

STUB PIGE STEILIIG CBAMB 

STXR2 PULSE SVC CEA12 

STX13 CHIIIGE S?C CBAB3 
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Proaraaainci Mote ; The isect CllSTX describes tlie sdiedule table le^el 
change -table. 



RELCORE — Belease Allocated Smiervisoi: Work Space 

RELCORE releases supervisor vork space allocated bj tbe GSTCORE 
Bacro. 

I 1 1 1 

llame {Operation {Operand | 

I 1 1 1 

I [symbol ]| RELCORE |IDI>R^LGH^TYPB=» | 

I 1 1 ^ ^ 1 

IBDR 

address of tbe start of tbe area to be released* 

Specified as ; a system address tbat is on a 6^-byte boundary* It 
■ay be given as register notation — 1 is allowed — or as a symbol 
defining a f nllvord vbicb contains tbe address of tbe area to be 
released* 

LGl 

lengtb of tbe area to be released* 

Specified as : a register notation — is alloved — or symbolic 
representation • 

ffPlsr 

same as tbat specified in tbe GETCORE macro* 

CAOTIOIS ; 

(1) Tbe PSA dsect CHAFSA must be copied by any module assembly using 
tbis macro* 

(2) Tbe ei:pansion of tbis macro is affected by tbe prior use of tbe C?T 
macro in tbe assembly* 

Examples ; To release an area of storage, code: 

RELCORE WRKADD^WRKLGH 

WRKADB DC A (0) area for saving address of work space 
WRRL&H BC H*128* lengtb of work space 

RESET — Reset Deviire Suppression Flag fRI 

Tbe RESET macro instruction cancels tbe effects of a previous PURGE 
macro instrnction by resetting a device's suppression flag in tbe TSBL* 

f 1 I 1 

I Hame | Operation | Operands I 

I 1 1 ^ 1 

I [symbol] I RESET ([device number] I 

I I I -J 

device number 

specifies tbe symbolic device address of tbe device wbose flag you 
wisb reset* 

Specified as : A one-to--four digit decimal number, eitber as an 
absolute expression or in register notation (2 tbrougb 12) ; or as: 
ALL if suppression flags o£ all devices are to be reset* 
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Default: ; It will be assuiied that the issuer has placed the syMJbol- 
ic device address in register 0. 

Executio n: The resident supervisor clears the device suppression flag 
in the task symbolic device list for the specified device address. 

Beturn Data ; If the device is not contained in the task's symbolic 
device list (an error) ^ the high-order bit of register is set to one. 

Bxanple : Suppose you want to allow I/O operations to continue on sym- 
bolic device 25. ¥ou might write: 

LH 2, =1(25) 
GO lESlT C2) 

RBSByiB ■ — Beset Immediate leport Flag fOI 

The RISITIB system macro instruction is used to specify that the im- 
mediate report error statistics for call type 25 fsee Test and Mainte- 
nance Pser's Guide ) channel inboard and outboard failures on direct 
access paging devices are to be ignored for a specified device; they are 

not to be recorded in the system's error recording areas on the paging 

drum and no message is to be written to the system operator. 

I r- ^ 1 ' — ■ ^ — — ^ •' ^ — -I 

I lame [Operation {Operand I 

I 1 1 ^ ^ _ ..^ ^ ^ 1 

|[symbol ]|fiBSlTIR IsymboUc device address I 

I 1 1 ^ ^ ^ ^ — . I 

symbolic device address 

specifies the particular direcrt access device whose entry in the 
direct access statistical data record (CIBPSD) is to be marked so 
that no immediate -report statistical data will be written on the 
paging drum. 

Specified as : I one-to-three digit hexadecimal number, as an abso- 
lute expression, or, if the symbolic device address is first loaded 
into register 0, as: (0) . 

Execution ; When IBSETIB (S¥C 223) is executed, the immediate report 
flag (PSDIB) in the system's direct access paging statistical data rec- 
ord (DSECT ceiPSD) is set off. This flag indicates to the system's 
error recording routines (see System Service BootinesI that any errors 
of call type 25 that occur on a specified device should not be recorded 
in the error recording areas on the system's paging drum. 

Programming Motes ; RESBTIfi is issued in system code as part of the 
BESET IB jcd> option of the VBEBEP command (see Test and Maintenance 
User's Guide ) . That is, when a privilege class E system programmer, 
using VMEBEP, elects the job option of BESET IB, the BESBTIB system 
macro instruction is executed as part of the resultant processing. The 
result is to reset the Immediate Beport flag (FSDIB) in CHBPSD, which 
inhibits all IBs for paging devices from being stored on the paging 
drum. 

The VMEBEP job options for printing out error reports scan type codes 
that have been recorded on the paging drum along with the error records. 
If the FSDIB flag had been off during all error incidents and the system 
programmer issues the VMEBEP job option SBIBCH XX25 at his terminal, 
there would be no error statistics on the drum from which a report could 
be generated. If the flag had previously been on, and some call type 25 
errors did occ^c on a paging device, those statistics would be written 
out in an immediate report. The immediate report flag PSDIB can be set 
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OE ¥ia the ¥11BEP job option of SIT IB (see Test and Haintenance User's 
Qttide ) . 

Example : To turn tlie iamediate report flag (PSBIE) off for a device 
whose symbolic device address is 2C^ a sfstea programmer might code: 

lAll lESlTIE 2C 



RESUME — Return to Calling Procyram CO) 

The RESUME macro instruction restores registers and returns control 
to the calling program. 

I r ^ 1 ^ 1 

IHame | Operation | Operand | 

I — ^ ^ 1 —4 ^ ^ ^ 1 

I [symbol] I RESUME |area^ {first register[ , last register]) | 

I I |[ ^RC=retnrn code] I 

I _ 1 . . 1 ^ ^ . ^ i 

area 

specifies the address at which the data to be restored is located • 

Specified as : In RX address, or register notation. If register 
notation is used, the address must first be loaded into the speci- 
fied register. 

first register 

specifies the first register to be restored from the specified 
area. 

Specified as : I decimal number or an absolute expression. This 
number must be greater than 7 and less than 16. 

last register 

specifies the last register to be restored from the specified area. 
The restoration has the same wrap-around feature as the STH or LM 
instructions . 

Specified as : I decimal number or an absolute expression. 

Default : If this operand is omitted, only the first register is 
restored. 



RC= 



specifies a return code to be sent back to the calling routine. 

Specified as ; A decimal number or an absolute expression. This 
number must be less than ^1092 and must be a multiple of four. 

Default: lo return code is sent. 



RETRHR — Load Saved Registers and Return 

RETRNR standardizes supervisor linkages. RBTRIR reloads the saved 
contents of a calling program's registers from the supervisor save area 
stack, sets up returning parameter registers and a return code, and 
returns to the calling program. 

182 



I ^ 1 ^T ^ ^ 1 

ilaae (Operation fOpeiraiid I 

I 1 4- ^ ' 1 

{[syabol ]|11T11B |BCs,pieg»,PS11SKs | 

I i J . i 



Imdiimtds the return code. 

Specified as ; a decimal niuiber to be placed in leglster 15, or 
specified as Begister 15 whicb aeans tbat it contains the return 
code and is not to be restored. 

P11G= 

identifies the register (s) containing paraaeters/^alues vhicb are 
to be returned to tbe caller in legister and/or 1 » 

Specified as ; one or two registers. If two registers are given, 
then tbe i^ontents of tbe first will be placed in legister 0, and 
the contents of the second in legister 1. If onlf one register is 
given, its contents will be returned in legister 1. See examples 2 
S 3. 

FSIHSK- 

specifies whether the sfstea mmsk was saved and is to be restored 
fron the sawed area. 

Specified as ; 

T - the nask is assnwed to hawe been sawed in the 68th bfte of the 

sawe area. 
M - the Bask was not sawed. 

oefanlt ; 1. 

CAPTIOBS ; 

(1) the 'BSk dsect CMPSI anst be csopied by anj asseablj using the llTlll 
■aero. 

(2) IITIII assnaes that a standard sjstea sawe was done. If not, 
results are nnpredicrtable. 

Prograaainq Botes ; The standard systea sawe area is 72 bytes in length. 
ThB format of the sawe area is as follows: 

ford 1 - pointer to the prewious sawe area, 
lords 2 to 17 - register sawe in the segnence li|-13. 
lord 18 - before return, it contains previous systea aask if saved; 
after return, it contains return c^de for debugging. 

Examples ; 

(1) Bormal return with a return code of 0, 

ISTBIB BC^3 

(2) lormal return with a returning parameter and a code in Begister 15, 

filTBMB PB1C;= (5) ,BC« (15) 

the returning walue from Begister 5 will be placed in legister 1 for 
return to the calling routine and register 15 will be unchanged. 

C3) leturning with return values in legisters 7 S 3, and a return code 
of 8, 
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SEflMl PlEG=(7r3) rlC=8 

legister 7»s iraltie will be returned in caller's legister 0^ and 
Register 3»s value will be returned in caller^s legist^er 1. Regist- 
er t5, on return^ will contain a return code of 8. 



RJBLC — Reaote Job Entry Line Control fOI 

The RJELC iiacxo instruction causes the resident supervisor to execute 
channel programs that enable or disable the line associated with a par- 
ticular remote device. It either enables the 2701 or 2703 channel con- 
trol unit to receive input from a remote 2780 card reader or disables 
any transmission between them* 



J J 1 

I If ame | Operation | Operand 

I 1 1 



I [symbol] I RJELC I 

I I L 



Bote ; There are no operands. {See Initialization.) 

Initialization ; Before issuing RJELC ^ register must be loaded with 
the symbolic device address of the remote device that is to be initial- 
ized, and register 1 must be loaded with an action code indicating 
whether the line to the device is to be enabled, disabled, or primed 
(i.e., reinitialized) . The requirements for writing these parameters 
are indicated below: 

Reg - sda Register must contain the symbolic device address as- 
signed during the system generation process. Tou may 
write: LI 0,1 where X is the decimal number assigned to 
the particular device. 

Reg 1 - codes 

Prime the line; reinitialize the specified line for data 
transfer (e.g., to regain line control after a 2780 time 
out condition) . 

1 Enable the line; activate the specified line and initia- 
lize it for data transfer. This operation is invoked as 
a result of the operator issuing the ASHBD command* 

2 Disable the line; deactivate the specified line after 
either normal or abnormal job termination. 

Execution : When the SVC 232 generated by RJELC is executed, the resi- 
dent supervisor attempts to execute channel programs which perform the 
operation requested (enable, disable, or prime) on the line to the re- 
mote device specified. The line can be a dedicated or dial-up line* If 
a dedicated line is enabled, the line is prepared to receive input from 
the remote device immediately. If a dial-up line is enabled, the line 
is prepared for receiving the dial -in and then, once the user dials in, 
the dial— up line is prepared to receive input from the remote device. 

Return Data : Registers 1 and contain the following parameters: 

Register 1 = Code Heanina 

SIO sucrcessful 

^ SIO failed; also examine register 

8 Path unavailable or invalid input 

12 Path busy 
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Iken tke return code in register 1 is 4: 

legister = 

I J . J ^ 1 1 . 1 1 

I SIO I flO I TCH I SIO I CSi status bfte | flags | 
I failure | condition Icoaditionl condition! if SI0 cc=1 r X»10» | 
I indication I code | code | code | | | 

I I ^ 1 ^ 1 1 . 1 1 

12 34 56 78 23 24 31 

there bits 0-1 If on, SIO failed (these bits not meaningful to aacro 

execution) . 

2-3 See TIO assembler instruction • 

4-5 See fCH assesbler instruction. 

6-7 See SIO assembler instruction. 

8-23 See CSI status bfte. 

25 If on, control unit busj . 

26 If on, expected interruption taken bj other CPU. 

Procrraaaina notes ; In TSS, IJEIC is issued in the BlLKIO Initialization 
routine in response to the ASIBD coasand. Prior to executing the S?C, 
the Initialization routine defines (via a SIl aacnro instruction) an in- 
terruption processing routine to service any asj nchronous interruptions 
froB specified lines that occur during the SVC processing, fhe 6UI.KI0 
Input Start routine is defined as the processor. 

Bxaaple : fhe line to the reaote device with the syabolic device address 
of 123 is to be enabled for receiving input. 

LOIB SfaBOLIC BIVICB IDDIBSS 

SET RIQOIST FOR 11IBLI16 OPBl&TIOl 



LI 


0,123 


1> TWT C* 


1,1 


SVC 


232 



BUPgV — Beaove Device Froa Task Symbolic Device List fRl 

The IHDBV aacro Instruction reaoves an I/O device froa four task's 
sjabolic device list. 

I 1 1 ^ ' 1 

INaae (Operation! Operand I 

■| 1 1= ^ ^ 1 

|[syabol]|llDBV |[devi€:e] | 

I 1 1 . 1 

device 

specifies the syabolic device address of the device that you want 
reaoved froa your task's syabolic device list (TSDL) ^ and whether 
the DEVT flag is to be set off. Setting the flag off indicates 
that the issuer does not vish to control I/O when that device is 
again assigned by ADDBV. (See the CIIIOC aacro instruction for a 
further discussion of the dbvt flag.) 

Specified as : legister notation (2 through 12) . If the two's coa- 
pleaent of the syabolic device address is used, the DEVT flag will 
also be set off. 

Default z It will be assuaed that the syabolic device address (or 
its two's €X>Bpleaent) has been placed into register 0. 

Execution: The resident supervisor reduces the IDDEV count in the 
task's syabolic device list by 1. If the count is reduced to 0, the 
device entry is reaoved froa the task's syabolic device list. 
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Betmrn Data ; If the syabolic ievice address is aot found ia the task's 
SYBbollc device list^ the supervisor sets the high-order bit of register 
to 1. 

gi:ample ; Suppose fou want to remove sjabolic devi<^ 46 from your sfm- 
bolic devicre list; assuming no other part of jour task had also added 
device %6^ the IDDEV count for device ^6 would be 1. Ton might write: 

LH 2,.=Y(II6) 
GOl llDlf (2) 



BHOVHI,B — Remove Page from Page Hold 

ElOflLD takes a Vll or a list of VIls and decrements the page hold 
count of each page by 1. 

I 1 1 1 

I lame {Operation {Operand I 

I 1 1 1 

ICsymbollIlHOfHLD | CVHA=|TCW=) ,fSI | 

t ■ , I 1 . 1 

virtual memory address of a single page whose page hold count is to 
be decremented by 1» 

Specified as : register notation (2 through 12 or 0), or a symbol 
defining a fullword containing the ?11. 

TCW= 

the address of a page list C^or format , see dsect CHATCl) • 

Specified as : register notation f2 to 12)^ or a symbol defining a 
fullward containing the fCl address* 

TSI= 

address of the fSI for the task owning the page or pages. The task 
must have been locked by the calling routine. 

Specified as : register notation (2 to 12 or 1) r or a symbol defin- 
ing a fullward containing the fSI address. 

CAPf lOHS : 

(1) The PSI dsect CHIPSl must be copied by any assembly using the 
IHOTHID macro. 

(2) The use of the C?T macro prior to the use of the SMOfBLD macro 
affects the expansion of this macro. 

Programming Motes : The macnros GETPIG and H10VHI.I> operate as a pair. 
The GSTPIG macro is used to bring the virtual memory page into storage 
and to placre the page in page hold, while the RHOYHLB macro is used to 
remove the virtual memory page from page hold when the routines are 
finished with the virtual memory page. 

Examples : 

(1) To remove a single page from page hold, code: 

BIOVHLP ¥11= (5) ,TSI= (2) 

(2) To remove a list of pages from hold when the list is in TCI format, 
code: 
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BHOVHLB TC1=C5) pTSI={2) 

t BQPAGE — Read Only Page Protection Flag Update CR) 

The HOPIGF macro instruction is used to test, set, or reset the HEAD 
OMLY page bits in the external page tables. 

r— ^ — 1-~ ' T ~-"-~ ~ ~ — ^ — " — • 1 

IName | Operation f Operand I 

I ^ 1 __4_™ _„_ _ _ _ ^ , 

![symbol IfPOPAGE |?!!A= ,COUIT=,OPTION= fTEST f SET |RESET| | 

L ^ 1 ^ _ -J ^ ^ — . — ^ — . , . ^ I 

VMA= 

addr€*ss of first page to be operated on. 

Specified as ; an RX address, or as register notation. "Execution 
time is saved if register 1 is specified. If register notation is 
used|. the address must first be loaded into the specified register. 

Defau lt ; Hone . 

COONT= 

nuib€»r of pages to be operated on. 

Spe cif ied as : an RI address, or as register notation Cs^<^ept 1) . 

Execution time is saved if register is specified* If register 

notation is used, the count must first be loaded into the specified 
register. 

Default : n o ne . , 

0PTI0N= 

indicates whether the REID OILY bits in the XPf (External Pacre 
Table) are to be tested, set, or reset. 

Spe c ified as ; TEST, SET, or RESET. 

Defa ult ; none. 

Return codes ; if OPTION=TEST, the following codes will be returned in 
register 15: 

Code Seanincr 

pages are not read only protected. 

k paaes are read only protected. 

8 pages are mixed; SET or RESET cannot be performed on this 
range of pages with only one issuance of the ROPIGE macro. 

12 indicates an erroneous count parameter. 

16 indicates an unassigned page. 

20 indicates nixed shared and private pages. 

Mote ; for return codes 16 and 20, the first erroneous address is 
returned in register 1. 

If OPTION==RESET, a return code is set as above. If the return code 

eguals 4, the READ ONLY protection bits were turned off. 

If 0PTI0II:=SET, a return code is set as above. If the return code eouals 
0, the READ ONLY protection bits are now turned on. 
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RFBMPT — Send Message to Task 

IPIHFT allows a smperwisor Module to send a message to a task usiEf 
tke Virtmal Hemorf Proiipt f acilitj « Tke EPllPT necliaEisa allows op to 
five variable message inserts. 

J,—— _— . — ^ — »-^.-__.^-^.«_---..g.--_.-_.— _..-_>^ ->__-__-_™-_-__>---- -.-^ — _™™-«.-,-« — ^ ^ 1 

llame | Op eration f Operand | 

l_ _._4_^.„..___^^_^ 1 

|[sfiibol]|lPEHPT |P1,F2^P3,P4,P5,HSGID=^TSI = ,TSKID= | 

L .„ ^ _-.»X-»-^ -__J— ....._--—____-__«— _.™™->™—-™^ — _-„.--_-- — «- . . I 

P1rP2,P3,P4^F5 

the variable aessage inserts; tlie foraat for Px is: 
fTIPE[,,LGH],IIHl) 

TIP! 

the converted display ckaracteristic of tlie parameter. 

Specif iei as ; 1 - printable hexadeciaal 

D - printable ieciaal nimber 
■iittll' - printable character string 

LGH 

designates the length of the field defined bj HUE. 

Specified as ; a number, 1 to 15. 

Defanlt: the length attribute fL^lIME) of the field defined 
bf iAME. 

the naae of a variable insert field to be converted, formated, 
and printed « 

Specified as : anf ter«p or register notation. 

iote : Onlf IIHI above aaj be given as other than a self- 
defining tera. 

address of an 8-bfte character field containing the aessage ID of 
the massage to be prompted. 

Specified as ; a systen address, or a character string. 

fSI= 

the address of a TSI which aaf have been locked bf the caller. 

{This parameter is used bf IPllPT to prevent an attempt to lock a 

task already locked by the caller.} 

Specified as ; an IX address or register notation 

TSKID= 

the IB of the task to receive the message. 

Specified as : an EX address or register notation or task id nnmber 

Default ; task 1 ~ SISOPEIO 

CA.PTIOMS : 

(1) The 'PSI dsect CHIPSI mist be copied and assigned a base register by 
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aaf assembly using this macro. 

f2) ThB expaEsiom of the RPHMPf macro is affected bf the use of the CfT 
macro prior to the use of the BPSHFT macro* 

Frogramminq lote ; For all variable insert parameters of tfpe •©•a left 
zero suppress is ione. 

Example s To send the followifig message to tha operator 

OllXFBCTEB IlTEimPf: SI)I=$i,CSi=$2; 

the EPiaPT macro would be codei like: 

IPllPT Prt^CTSDI) ,. (l,8^GQlCSi) ,HSGID=»CEIf A001 %TSI= C1EG2) ,!PSKID=1 

Willi fCf SBl is a half word field which coataias the SDA of the device 
and GQECSl is an 8-bfte field containing the CSl from the interrupt 
being recorded. The macro assames that the specified HSGID exists in 
either fSS STSIIB SfSMLP or in the iiser»s USIELIB STSHLF* 

RSIG — ies e rve Segment fOI 

The ISIS macxo instruction transfers control to the reserve segment 
program in the resident supervisor*, ia attempt will then be made to 
reserve the specified segment groap. 



-r— ^ — - — ^jj~ — _ 

I Operation I Operand 

-I __+»_»_.— 

IBSIG f 



lame 



Wote ; There are no operands- 

Initializat i on ; Before executing ISIG, the issuing program should have 
set up the following parameter area: 

CHAiSG DSECT , C0RHO1 IIMISBG PIRIHETIH LIST 

DS OP 
ISGSfC DS H S?C 

DS 112 lESElfEB 

llSEEflD SBGBIIT GROOP IIIE 
BISCOIIECTEB SEGllIT GIOUP IIHI 

fllTllIL STORIGE IDDHISS OF SIG GIOIP 

lElGTH OF IIIEB GHOIP 

I1P0T FLIGS 
OOTPOT FLAGS 
DIIKB SPECIFIED 
ISIIE SPECIFIED 
IDDIESS SPECIFIIB 
MOBB^BOOIID 
IIMGTH SPECIFIED 

IBSllfED 
*-C-flIlSG LBIGTH OF PiliariEB IIST 

RSIG mast be the object of an execute instruction and be fullword 

aligned. 

Ixectttion: This macro instruction passes control to the resident super- 
visor module CEIP2 via SIC 180. in attempt will then be made to reserve 
the specified segment group. 



iSGRlI 


DS 


118 


ISGBIA 


BS 


X18 


ISGfHl 


DS 


I 


ISGLIG 


DS 


1 


ISGFLI 


DS 


XL1 


ISGFLO 


DS 


XL1 


BSGD16H 


IQl 


I«80» 


ISGRBGfi 


EQII 


f ■40» 


ISGIBGH 


EQIJ 


X»20» 


1S6B1B1 


EQII 


X»10« 


ISGLIGI 


EQl 


X»0&« 




DS 


F 


ISGLTl 


EQO 


*-€BA 
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Prograaalna Mote : The sjstmm prograaaer should use the BS7S1G aacro in- 
strmction described In Asseabler Pser Hacxo iBstgnctlon , GC28-200%, 



BSPBV — Restore Privilege JBI 

The RSPB? aac^ro Instrucrtlon retmims control to a caller who used 
trpe-3 linkage or to any non -privileged interruption routine dispatched 
bf the task monitor. 

r "" ' 1 Ti ^ ' 1 

I Vane | Op erationi Operand I 

I 1 ^ ^ ^ ^ 1 

|[synbolUlSPl¥ | I 

I I -I ^ > 1 

lote: There are no operands. 

Initialization t k BCLASS nacro instmcrtion with the OSll option nast be 
coded in a nodule prior to eroding ISPIV. It nore than one BCLASS nacro 
instruction is issued in a nodule, the last BCLISS issued prior to cod- 
ing BSPIV must be issued with the USEB option* 

Bxecution : 1 task-SfC interruption is created to transfer control to 
the task nonitor. After return fron a non-privileged interruption rou- 
tine, the task monitor restores all registers to their values at the 
tine of the interruption and then scans for more interruption routines 
to dispatch. To complete tfpe-3 linkage, the task monitor restores 
registers 2 through 14 to the values they contained when received, from 
the privileged cialling program. Begisters 0, 1, and 15 are left 
unchanged (see "Linkage Conventions") • Control is then returned to the 
privileged program vhich invoked the type-3 linkage. 

Example ; Suppose you have written a type-3 program which has received 
control fn» the Leave-Privilege routine and is now ready to return con- 
trol to the privileged calling program. Tou might write: 

BBPABT BSPBV 

Tou could also write: 

BB II 

sin<:e register 14 is set to point to an SVC 120 by the Leave-Privilege 
routine. Be turn from a non-privileged interruption routine dispatched 
by the task monitor can also be coded either way. 

BSSBBB — Indicate ISS Logic Error 

BSSSBB informs the BSS user of the occurrence of an BSS logic failure 
and saves error conditions at the time of the logic failure for easier 
debugging and recovery. 

J J ,^ ^ . 1 

IVame | Operation {Operand I 

I 1 — . 1 ^ 1 

|[symbol]|BSSEBB |SEV,CODE,IB | 

SBV 

indicates the ise verity of the error. 

Specified as : 1 - minor, restart should be successful 

2 - major, results of any restart are unpredicrtable 
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CODE 

represents a four-byte ideatificatioa number 

IB 

represents tbe ID of tke aodutle discovering the logic failure 

CAOTIOMS ; 

BSSESl can only be used wihtin the ISS environnent. The HSSIBH issues 
an ISS SVC which may cause unpredictable results if SSS is not active. 
(2) Currently HSS error module CEHEl stops execution on both ninor and 
major ESS errors* To attempt SSS restart, press the cpu restart key 
twice • 

Programming Motes ; ISS will print/display the following message when an 
ISSEll is encountered: 

..^*****£llIioi|M&J01]i ISS ERIOE 00002 pioi MODOLE : module name^ 

.•.EllOfi PSi: .. •fYPE-CPEOGRlM|S?C]*...error psws. ..error code« 

REGISTERS:^ REGISTEEO RBGISTEll EEGISTEE2 REGISTER3 

EEGISTER4 1BGISTEE5 SEGISTER6 EEGISTEB7 

EEGISTBE3 REGISTEB9 lEGISTERlO EEGISTBB11 

EEGISTBR12 R1GISTEE13 EEGISTBBI^ EBGISTER15 

^MIHOHfifJlJOE - severity of detected error. Currently, recovery is 
the same; the ESS user must press the EESIIRT key on the CPU twice 
to reinitialize ESS. 

2th is field contains the error code from the RSSEfiE macro to help 
the programmer to determine the errror encountered. 

^Module ID of the module issuing the error macro, or receiving the 
program check. 

♦PBDGRAa|S?C is the type of error indication: 

PEOGEAH - error was an unexpected program check 
S?C - error was a ESSERR macro call 

terror psw - the PSW at the time of the error 

^interrupt code - the interrupt code from the error. 

^registers ~ the contents of the registers at the time of the error 
indicator. 



I asvSEG — Reserve Segment Group ( (01 

I this macro instruction is completely documented in the Assembler User 

I lacro Instruction manual , except for one operand that is available only 

I to a systems programmer. The definition and specification for only that 

I one operand are given below, but for continuity, the metalanguage format 

I that follows shows all the operands. 

I I^'^form 

• — T 1 1 

I llame |Operation|Operand | 

I 1 1 1 

I ISymbol IRSVSEG | [ ElIi!E=,LBHGTH=^BSTECT=, ] HF=L | 
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E-for» 

I i ^ni ~~ ~ ^ ^ • 1 

llase I Operation t Operand I 

I 1 ^-1 ^ ^ ^ 1 

I [ symbol ]|1STSES |[llIHB=,LlHGf H=,IDDlBSS=rlSTHCT=, ] 1F= (Enlist) | 

I 1 ^-j . ^ ^ . 1 

Standard --f ora 



I lame i Operation | Operand 

I 1 + 



I [symbol ]|ES¥SBG |[lIlHE==,LElGTH=^lDraBSS=,RSflC!l?=] 

I I -J . ^ — 



Mote ; All operands are keyword. 

1S1?1CT= 

specifies wbetber system GBTllIl regmests will be allowed in tbe 
r served segment area when tlie area bas been disconnected with tbe 
1BLE&S=Y option specified in a BISCSBG or BICSBG macro. 

Specified as : 

f - system GB1*II1II requests will not be allowed even tbongb 1BI.B1S= 
1 was specified in a DXSCSEG or EICSBG macro. 

M - system GBTHIII reg mests will be allowed if lBLBlS=y was speci- 
fied in a PISCSBG or EXCSBG macro. 

This option is available to privileged class programs only, lefer 
to GBTIJLIII, BISCSBG^ and EXCSEG macros for further information. 

ITEM " Betiirn and Cleannp fask (M 

The El^EH macro instruction causes the system •s command analyzer to 
cleanup a task prior to task termination. {llso see the ETBl command in 
Command System Pser's Guide . I 



i 1 '^ ^ 

I lame | Opera tion | Operand 

I 1 -I ^ 



|[symbol ]|E!irEl | 

I 1 ^-i«. 



Mote : There are no operands. 

Executio n; I, task-S¥C interruption is created to transfer control to 
the task monitor. The task monitor in turn calls the Command System 
ETBl routine which resets the task as follows: all user SIEs are for- 
gotten as are all user interruption routines and active user programs; 
the source list is reset to its initial state and all pending attentions 
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iron tlie teraiaal arci discarded; if a US ITT had been givea, the CoamaEd 
System regains control of attentions (jnst as if a CLIfT kad been is- 
sued) ; all AETD»s ar€i forgotten. 

Exanple : If the program you caused to run is finished and yon want to 
return control to th€i coanand analyzer for end-of~run processing^ you 
night write: 

IIIE ITEM 



I RTTCTL — Real Time Task Contix>l CQI 

The ITTCTL macro instruction pro¥ides four functions^ which are de- 
fined below, for controlling real time tasks. 

• 1 1 ^ ^ ^ ^^ ^ ^ ^ ■ ~-i 

I name (Operation! Operand | 

I 1 1-, ^ _ ^ . ^ ^ 1 

([symbol ]|1TTCTL | desired function I 

I , I 1^. ■ ^ ^ : ^ ■ 1 

desired function 

identifies the real time task control function. 

Specified as : 

IHITIAL - initialize the task for subsequent delta time waits and 
turn on the real time flag. 

PWIIT - setup for a future timer interrupt, turn on the real time 
flag, and place the task in AillT until the interrupt 
occurs . 

BlIIT - setup for a timer interrupt, according to the base and 
delta times previously specified, and place the task in 

IIIIT until the interrupt occurs. 

CLEAR - clear all time values and turn off the real time flag. 

D efault : none. 

Initialization : for certain functions, registers 0, 1, and 15 must be 
loaded with time values in microseconds. The following table indicates 
the time values required: 

code registers 0:1 register 15 

lilTIIL base time delta time 

FWAIT future time 

BW&IT 

CLEIR 

k DCLISS macro instruction with the FSIflLEGED option must be coded 
in a CSECT prior to eroding RTTCTL. If more than one 0CL&SS macro in- 
struction is issued in a module, the last DCLASS issued prior to coding 
RTTCTL must be issued with a PRIVILEGED option. 

CAPTIQl : the time specified in registers 0:1 must correspond to a point 
in time greater than the current time of day clock. The delta time 
specified in register 15 must not be zero. Registers 0, 1, and 15 may 
be modified during execution of this macro instruction. The real time 
flag turned on by this macro instruction assumes that page stealing is 
specified in the schedule table levels used by this task. 
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Exectttio n: the Fillf aad BIIIT codes cause an entry to be created in 
tlie real time interrupt gueme for this task. For the FWAIT code^ the 

interrupt ti»e is taken directly from registers 0:1. For the DIIIT 

code,, the interrupt time is 



(BISl THE) + 1*(BELTI Till) 



where 1 is the number of times the DillT code has been issued since the 
last lilTIIL code. 

then the time interrupt occurs the task is moved to the active list if 
necessary. The deadline dispatch time is computed and stored in the 
task's fSI for processing by the dispatcher. This deadline dispatch 
time is formed by adding the timer interrupt time to a dispatch delay 
time speacified in the real time task control S?C processor. The dis- 
patcher will (in a multi-CPO configuration) stop the other CPU from 
executing in a lower priority task so that a higher priority task with a 
deadline dispatch time may be placed in execution. 

The real time flag turned on by this macro instruction disables the time 
slice end function of purging pages. This tends to keep the task's 
pages in real storage for extended periods of time. 

Return data ; one of the following return codes is placed, in register 15 
upon completion of execution for this macro instruction: 

code meaning 

no error 

4 invalid delta time 

8 invalid base of future time 

12 not used 

Programming notes : all times specified in this macro instruction must 
be in microseconds. The current time in microseconds may be obtained by 
using the STCK instruction and shifting the result to the right 12 bits. 

Example : assume you wish your task to be placed in execution exactly 
every tenth of a second beginning about 10 seconds in the future. You 
might code: 



ITll 



CLOCK 



STCK 


CLOCK 


GET TIHE ♦ I BOOT 10 SECOIBS 


LE 


0,1, CLOCK 


# 


IL 


Ot=F»10« 


m 


SIDL 


0,12 


* 


% 


15,=F»100000' 


SET .1 SECOIBS 11 HICIOSBCOIBS 


ITTCTL 


imTI&L 


IlITIALIZE lEIL TI»E TISK 


BS 


OH 




ETTCTL 


BllIT 


HIT FOB TUBE 

1 
>P10CBSS 

1 

BIIICH TO i&IT 


. 




B 


1T11 


BS 


B 





SAMPLE — Sample Statistical Recording Fields COI 

The SIEPLE macro instruction moves system status information, main- 
tained in main storage, into virtual storage. 
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I 1 J., ^ 

flaae | Operation (Operand 



I [symbol ] I SIMPLE | 

I I 1-. 



Mote ; Inhere are no operands • 

Initiali zation : Before executing tke SlHFLl macro instruction t one of 
the following codes aust be set up in general register 0: 

Code Meaning 

4 SIMPLE task paging activitf 

6 SIMPLE system statistics 

8 SIMPLE task schedule table history 

then ni^ng codes 4 or 8^ the SIMPLE macro instruction may be executed in 
line with other program instructions. Ill data are required in the 
floating point registers • 

then using code 6^ SIMPLE must be the object of an EXECOfE instruction •> 
S¥C 193r which SIMPLE produces, must occupy the first half word within 

the virtual storage page where the statistical data is to be recorded. 
Ilso, the second double word, bytes 8 through 15, of the virtual storage 

page must contain one of the following 8 byte character strings: 

Character Stringr Meaningr 

•SYSTEM • SIMPLE system parameters 

•SLOBIL • SIMPLE global system statistics 

•LOCIL • SIMPLE memory and task statistics 

CIgTIOH: Use of the SIMPLE macro instruction {SfC 193) is restricted to 
tasks having system programmer authority (0 or P) . 

Executio n; On execution of the SIMPLE macro instruction, statistics 
maintained in main storage system status table (CHBSST) and several oth~ 
er system tables, are moved, depending upon the code in register 0, into 
either the virtual storage page containing the SIMPLE SVC or the float- 
ing point registers. 

the SVC routine checks whether the data area in the receiving page is 
equal to or greater than the data bytes to be transferred. If it is 
not, data transfer is halted when the area becomes full. 

Be turn Hata ;' Ifter execution of the SIMPLE macro instruction, one of 
the following return codes is placed in general register 15; 

Return Code Meaning 

no error 

4 invalid code in register 

6 SIMPLE SVC not in first 

half word of virtual storage page 

Code 4 in general register provides the following task related coun- 
ters in the floating point registers: 

F. P. heqister Contents 

private drum reads 

1 shared drum reads 

2 private disk reads 

3 shared disk reads 

4 reclaimed pages 

5 SWCs issued 

6 relocation exceptions 

7 auxiliary pages 
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Code 6 in general register transfers data to a virtual storage page. 
BSECTs are provided to cover tke three types of data transfers: 

Data DSECT 

systea parameters CHIPXS 

GLOBAL SISfEM STATISTICS CHASTV 

HIMOIX AMD TASK STATISTICS CHATSX 

Code 8 in general register produces tlie following task related data in 
the floating point registers: 



P^ Regi s ter 

1 
2-5 



Contents 
task tiae in Billiseconds 
count of time slice ends 
last 16 schedule table levels used 



Mote s All data returned in floating point registers are in fixed point 
foraat« 

Prograaainq Hote : Additional information pertaining to the use of 
SAMPLE can be found under "Evaluation of System Status Statistics,** 

Exaaple s A systea prograaaer wants to extract the current systea para- 
meters (described by CHAPXS) . He might write the following: 



GETMAIM PAGE^L?=1 


LI 


3,1 


USING 


CHAPXS,3 


avc 


PXSSVC^SAHP 


IfC 


PXS2rAKE,=CL 3 •SYSTEM* 


LA 


0,6 


EX 


0,PXSSfC 



GET PAGE FOE DATA 

COVBl PAGE 
IHITIALIZE PAGE 
IMITIALIZE PAGE 
SAMPLE CODE 
EXECUTE SVC 



SAIP SAHPLE 



SAVEB — Supervisor Standard SAVE Function 

SAVEl standardizes the supervisor function of saving the calling 
aodules*s environment and registers. Upon exit. Register 13 points to 
the save area containing the calling module's saved registers* 
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I i ^ r—^ ^ ^ 1 

IHase lOpeiratioQlOperand I 

I 1 , 1 ^ ^ 1 

Itsynbol JIS&VSl | ,I.6H I 

I 1 . 1 . 1 

Mote : The first operand is ignored; it is only included to Maintain the 
correct paraaetcir displacement. 

I.6H 

the length of a work area to be allocated froft the save area stack* 
The address of the beginning of the work area will be returned in 
fiegister 1^1. 

Specified as ; an integer nnaber 1 - 256^ or register notation 

C&OTIOS : The FSA dsect CHIPSl nizst be copied bf anj assenblj nsing the 
SA?SB macro. 

ProaraMsinq Motes ; The standard TSS supervisor S&¥E area is 72 bjtes in 
length. The registers are saved in the segnence 1%-13. The format of 
the SI¥E area is as follows; 

lord 1 - pointer to previous save area nsed by the calling module* 
fords 2-17 - contents of the calling module's registers in the 

sequence 14-13. 
lord 18 - ttsed as a work area. 

Each CPU in a TSS configuration is assigned its own save area stack 
which is pointed to bf the CBJJs PSi. iithin the PSI is another pointer 
to the next available word in the save area stack. Is a program is 
called and does a SI¥E1, GlTiOlK, and IBTBHB, this PSA pointer is updat- 
ed to reflect the next available area. When a SA7EP is done the current 
value of the PSA pointer is saved in the first word of the save area. 
Then as the GBTWOlKs are issued the pointer is updated to reflect the 
allocated areas.. Finally when the module issues a RETIMB to exit, the 
saved PSA pointer is restored to the PSA and any allocated work areas 
are made available for reuse. 

The PSA save area pointer is reinitialized to the top of the stack on 
each pass through ClAJQS . It is the responsibility of any module exit- 
ing out of line IT expecting to be returned to later to resume execution, 
to save the savc^ area stack, allocate a new stack, and when resuming 
execution, to riilease the current stack, and restore the saved stack. 

Example: To save registers and allocate a 64-byte work area, code; 

SAfEB ,6<( 

After execution J, Begister 13 will point to the start of the save area 
and Begister 14 to the start of the work area. 

SCIED - Schedule Table Entry iWi 

The SCBEB macro instruction is used to communicate a schedule table 
entry (STE} to the supervisor for use in scheduling a task. The infor- 
mation is placed in the task's TSX. 

I -T 1 ' 1 

(lame (Operation (Operand | 

I 1 ^^ 1 . — ^ . f 

([symbol ] I SCHED | ( 

I 1 . 1 ^ . 1 

Mote ; There are no operands. 

Executio n; The SCHBD macro instruction forms a value made up of the 
user's schedule table index Jwhich identifies th^ user's priority) and 
the type of task (conversational or batch) . This value is placed in 
register 15 and is passed to the resident supervisor by means of the 
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CHIIGE saciro in struct ion r asiag the STl code in that macro instruction's 
operand. 

He turn Data : See the CHIISE macro instruction. 

gy ample ; Suppose that a conversational task is switched to the back- 
ground and you want to establish a new schedule table entry for it. To 
communicate a new STE to the supervisor, you write: 

lllB SCHED 
SCBTSI -- Special Create Task Status Index fB> 

The SCITSI macro instruction allocates storage for and initializes a 
TSI regardless of the number of TSIs already defined. (CRTSI provides 
the same service, but places a limit on the number of TSIs that can 
exist at one time.) 

I 1 1 1 

flame | Operation} Operand I 

I 1 1 1 

I ([symbol ] I SCH TSI |[taskidl | 

t 1 I . . 1 

I taskid 

I specifies the taskid to be assigned to the TSI that is to be 
I created. 

I Specified as : an IX address. 

I Default : none. 

Initlali zation : I DCLISS macro instruction with the PlIflLBGBB option 
must be coded in a CSECT prior to coding SCITSI. If more than one 
DCLISS macro instruction is issued in a module, the last BCIASS issued 
prior to coding SCITSI must be issued with the FRIVHEGED option. 

Bxecutio n : k new task status index is created regardless of the number 
of TSIs in existence. If the system TSI limit has been reached, it is 
incremented. Ifter the TSI has been created, the limit is restored. 
For an explanation of how the TSI is initialized, see the CITSI macro 
instruction. 

Return Pata : The id of the new task is returned in register 0. 

Example : If you want to create a TSI, you might write: 

ABC SCRTSI 

SETAE — Set Asynchronous Entry CRI 

The SETAE macro instruction indicates which task is to receive asyn- 
chronous interruptions from a specified device. 



• 1 1 

I lame | Operation | Operand 

I -4 h 



|[ symbol ]| SETAE ([device number ][, task] 

t I I 



device number 

specifies the symbolic device address of a the device to be set. 

Specified as : Register notation (2 through 12) . 
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Default s It is assumed that tlie issuer has loaied the sjmbolic 
devic^e address in register 1. 

task 

specifies the identificatioa of the task to which the device is to 
be assigned, whether the dewicre is to he made anassigned {restored 
to a neutral state) , and whether the DBYf flag is to be cleared. 

Specified as s Register notation (2 through 12) , expressing the 
task identification (taskid) , if the device is to be assigned. The 
value Bust be xero if the devic^e is to be made unassigned* If 
I«FFFFFFFF» is specified in register notation, the device is made 

unassigned and the BS¥T flag is cleared C^^^ the description of the 
CKALOC macro iastruction for a discussion of the PEVT flag) . 

Default ; The devi€:e is made unassigned. 

Execution ; The entrj in the asf nchronous device group table (CHBIDI^ 
for the specified sjmbolic device address is set to point to the task 
status index of the task referred to bj the task ID. If no task operand 
is specified, the sjmbolic devicre is marked unassigned. In entrj is 
also placed in the TSDI. of the new task. 

Example ; Suppose fou want attention interruptions received from device 
124 to be processed by the task, having task identification 233. You 
might write; 

LI 2, = r{12«l) 
IH 3, =1(233) 
EST SETIE (2) , f3) 



SETCTL — Set Control Registers IBI 

The SETCTL macro instruction allows fou to set selected task control 

registers. 

I , — , , ^ — ^ ^ — ^ . J 

I lame {Operation {Operand | 

I 1 i _ ^ ^ 1 

I [symbol]! SETCTL |[ field- ClCllSK|FElil.SK|FBRGS|PEHlDDl| f 15) } ] | 

I 1 1 ^ ^ ^ . 1 

field 

designates the control register function you wish to set and may be 
written ; 

ICl&Sl - sat monitor call mask CI 8 bits 16-31 
FERHASK - set program event recording mask CI 9 bits 0-3. 
FEBGl - set FEE general register mask CI 9 bits 16-31. 
FEllDDl - set FEE address range CI 10-11. 

If you choose to write register notation, you must select the prop- 
er value from the list below and place it in register 15 before 
issuing the macro instruction. 



Code 


Value 


RCHASK 


1 


PESHISK 


2 


PBB6B 


3 


PERADDB 


4 



Initialization ; A IKTLASS macro instruction with the FlIflLESED option 
must be coded in a CSECT prior to coding SETCTL. If more than one 

Section 2; System lacro Instruction Descriptions 195 



DCLASS aacro instrucrtioii is issued in a module, tlie last 0CI.ISS issued 
prior to coding SETCTL nmst liaTe been issued with the PHITILBGID option. 

Execution: Tlie contents of registers and 1 are placed in the control 
register save area of the XTSI corresponding to the code contained in 
register 15. The control registers are subsequently loaded froa this 
save area before the task is placed in execution. The nuaber of bjtes 
to be inserted into the control register save area depends on the code: 

Code Implied Length fbvtesl 

1 2 

2 1 

3 2 
«l 8 

legardless of the length, the bftes are always to be right- justified in 
registers and 1 . 

Example : Suppose you wish to enable monitor call class 2. This is con- 
trolled by turning on bit 18 in control register 8. SETCTL replaces bit 
positions 16-31 in crontrol register 8, so an XTICTL macro should be used 
to inspect the current bit settings in control register 8. Then you 
might write: 

LI 1,288 

EHIB2 SETCTL IClISi: 

SETIR — Set Immediate leport Flag fOI 

The SETH system macro instruction issued to specify that the immedi- 
ate report error statistics (call type 25 channel inboard and outboard 
failures on direct access paging devices) for a specified device are to 
be recorded in the system's error recording areas on the paging drum. 
(Ilso see Test and Maintenance User's Guide ) . 

I 1 i 1 

I Name (Operation {Operand I 

I 1 1 1 

|[symbol ]|SETIB Jsymbolic device address ( 

I 1 1 1 

symbolic device address 

specifies the direct access device whose entry in the paging sta- 
tistical data table (CHBPSD) is to be marked for immediate-report 
statistical output to the paging drum. 

Specified as ; The hexadecimal eguivalent of the symbolic device 
address (usually expressed in decimal) or, if the symbolic device 
address is first loaded into register 0, as (0) . (This may be done 
by a Load Address instruction, expressing the symbolic device 
address in decimal.) 

Execution : When SVC 223, generated by SETIl, is executed, the immediate 
report flag (PSBIl) in the system's direct access paging statistical 
data record (DSECT CEIPSD) is set on. This flag subseguently informs 
the system's error recording routines (see System Service Routines ) that 
call type 25 errors that occur on a specified device should be recorded 
in the error rec:ording areas on the system's paging drum. 

Programming Botes : SETIR is issued in system code as part of the SET IE 
job option processing of the VHEREP command (see Test and Haintenance 
Oser's Guide ) . Thus, when a privilege class E user (system monitor) , 
using fMEREP, elects the job option of SET IR, the SETIR macro instruc- 
tion is executed as part of the procressing that results. 
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Tke fHiiBF job options for printing error reports use statistics that 
have been recxirded on tbe paging drna. If tbe FSBIB flag is on, and tbe 
user issues the fMllEP job option SIAICH 1125 at his terminal, then a 
report based on anj statistics that aaj haire been recorded in the dma 
(the innediate repoirt) womld be printed at his SfSOilT deviire, listing 
all devices that had errors of call tfpe 25 (and each such error on the 
device) • The format for these ianediate reports is described in the 
Test and Maintenance Pser's Gnide > 

then the PSD II flag is off, call tfpe 25 errors on the associated device 
are not recorded on the drnn; in this case no ianediate report statis- 
tics are available (unless the FSB IB flag had previonslj been on) vhen 
the privilege class £ user elected the job option SSIICI 1125. The 
THEIEF job option BESET IB can be nsed to set the FSDIB flag off (see 
also the description of the BESETIB sacxo instrnirtion) . 

Exafiple: To turn the innediate report flag (FSDIB) on for a device 
whose syabolic devii^e address is hexadecimal 19, a sjstem programmer 
might code: 

IIME SETIB 19 

SETLOCK — Set a Besident Snpervisor Lock Byte fO) 

The S£Tn>CK macro instruction locks a designated table or function in 
the resident supervisor, protecting the table or function in an HF or IF 
(two proi^essor) environment. 

I 1 !l ^ ^ " 1 

llame (Operation {Operand | 

I 1^ ^1 ^ ^ ^ 1 

f[sjmbol]|SETLOCK f[count register ],lockbfte,[ module id}, | 

I I |[error number], {IlIEDIlTB|SHOBTtLOIG} , action, | 

r I |[ exit address ],[ {LOG I WOI.OG) 1 | 

I 1 II ^ ^ . I 

count register 

specifies a register to be used for counting time increments* This 
operand is reguired if SHOIT or LOIS operands are specified; it 
will be disregarded if the IllEBIITB operand is specified. 

Specified as : In absolute expression from to 15. 

lockbyte 

specifies the address of a location that is to be set to 1»FF» 
using the TS instruction. 

Specified as ; I symbolic address. 

module id 

specifies the nodule trying to set the lock byte (the module in 
which the SETLCICK is issued) . This operand will be used in 
generating a SISEB message in the event the attempt to set the lock 
byte is unsuccessful. This operand is reguired if the SHOBT or 
LOHQ operand is specified; it is ignored if the IHHEBIITE operand 
is specified. 

Specified as : I two-digit decimal number. 

error number 

specifies this particular SETLOCK macro instruirtion within a module 
in which more than one STSEB is issued. This operand is used in 
generating a SYSEB message in the event the attempt to set the lock 
byte is unsucc€issf ul . This operand is reguired if the SHOBT or 
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LOMG operands are speirified; it will be ignored if the IlllDIATl 
operand is specified. 

Specified as : I two-digit decimal number. 

IHHIDIITSI SH01TII.0I6 

specifies how long to keep trying to set tlie lock in tbe event it 
is aire ad J locked. 

Specified as ; 

IHHEBUTl (only try to set it once) 

SHOlf (keep trying nntil a length of tine has elapsed) 

LOIG (means the sane as SIOIT) 

action 

specifies what to do if the attempt to set the lock fails. 

Specified as : 1 symbolic address to which to branch if the IHHEDI- 
Ifl operand was specified. 

exit address 

specifies where to branch to if the lock was set or if a SfSlH 
occurred. 

Specified as : I symbolic address. 

Def anlt ; The program continues at the next segnential instruction. 

LOGIMOLOG 

specifies whether the address of this SBTLOCK macro instrnction is 
to be logged in the logging field associated with the lock byte. 

Specified as : LOG or lOLOG 

Defanlt : lOLOG 

C&OTIOl: This macro instrnction can only be issned within modules com- 
posing the resident supervisor. 

SITSYS — Stet System Table Field fB) 

The SETSys macro instruction sets or alters one of a selected set of 
system table fields. 

I 1 r— ^ 1 

I lame {Operation (Operand | 

I 1 1 1 

|[symbol3|SlTSys [[field J | 

I 1 1 ^ ^ I 

field 

designates the system table field you want to set or alter. 

Specified as : TISKIIIT 

you may also use register notation by selecting the proper value 
from the list below and placing it in register 15 before you issue 
the macro instruction. 

Code Yalue 
TASKIIIT 3 

Default: It is assumed that the issuer has placed a value in 
register 15. 
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Initialization : I DCLASS »aci:o instruction with tke PBITII.1G1D option 
■nst be coded in a CSlCf prior to eroding SlTSIS. If sore than one 
nci»JlSS macro instrnirtion is issued in a nodule, the last BCLISS issued 
prior to eliding SETSIS nnst be issued vith the P1I¥I1E61B option • 

Execution ; The contents of registers and 1 are placed in the systen 
table field corresponding to the code contained in register 15. The 
ntmber of bytes to be inserted into the sfsten table depends on the 
code: 

Code Implied Length fbytesi 

Example : Snppose yon want to inhibit the initiation of any more tasks. 
This is controlled by a flag byte in the system table called SfSTI; the 
appropriate bit mask is called ^ISTIH. The task initiation bit is bit 2 
of the SfSTI byte. SETSIS replaces the entire flag byte, so an XTISYS 
should be used to extract the flag byte* Then yon might write: 

BOOG SETSIS TISKIMIT 

SETTIMEB — Set Bealtime Interval From Besident Programs fSl 

The SETTIIEB macro instruction sets a realtime interval after which 
the system generates a timer interrnption and passes control to a speci- 
fied routine • 

J J J ^ J 

I lame | Operation (Operand I 

I , , ^ 1 

I [ symbol ]( SETTIIEB ftime , return parameter | 

I I I interrupt routine entry point , option | 

I 1 I. ^ ^ . 1 

time 

specifies the length of time in microseconds after which a realtime 
interruption will be generated. 

Specified as : 1 decimal number, or, if the decimal number is first 
placed in one or two registers, in register notation. In register 
notation, if the number is too large for one register, it may be 
loaded into two contiguous registers and they may be specified as, 
for instance: (3,^) • 

return parameter 

a value to be returned when the realtime interval has elapsed 

Specified as : Begister notation (2 through 15) . 

interrupt routine entry point 

specifies the routine that is to receive control when the specified 
timer interruption occurs. 

Specified as : In entry point name, or, if the address of the rou- 
tine is first loaded into a register, in register notation (2 
through 15) . 

option 

specifies the type of value given by the first operand (time) 

Specified as : IBS. If this operand is omitted or not ABS, the 
time value in the first operand is an interval. If IBS is coded 
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time is an absolute time when the interrupt is vanted. For exam- 
ple ^ a time aaj be calculated £or the next hour, shift ^da^, etc. 

Initialization ; 111 modules using the SETTIMIB macro instruction must 
haire a copy of the DSICT CHIPS& and a USIHG CHAPSl statement. 

CAUTIOH: If the second operand is missing, a comma must be included to 
indicate its absence. 

Execution ; If either the time or routine operand is not present, an 
error is indicated. Control is passed to the Set Realtime Interruption 
routine. The realtime interruption is eventually placed on the realtime 
interval queue (CHIBTI) in the field BTITIIB. Control is returned to 
the user with a return code set in register 15. 

Return Data ; Register 15 is set to 08 ~ normal return. 

If the program using SEfTIKlR wants to replace an existing interruption 
with a new one (new tiile value) , the programmer must use the same rou- 
tine and ISI addresses as were used by SBTTIKER when it first placed the 
interruption on the queue. 

The CIHCL macro instruction can be used to cancel a programmed realtime 
interval previously established by a SETTIMER macro instrucrtion. 

Example ; In EX1, below, a realtime interruption is desired 100 micro- 
seconds from the present time. In EX2, a realtime interruption is de- 
sired three minutes from the present time (that is, 180000000 microsec- 
onds) . In E13, an absolute time has been calculated in Registers 4 and 
5. 



EX1 



S ETTIHER 
SETTIMER 



8,TSIIIDD 
100, (8) ,CEAH& 
or 
100,,CE1H1 



E12 



EX3 



LR 
SETTIMER 

SETTIMER 



2,TSIADDR 
180000000, (2) ,CEIHJi 

(4,5) , (2) ,CEIM1 



SETTR 



Set Real Time Interval fOI 



SETTR sets a time limit, in terms of a real time, on the execution of 
your task. 



|5ame 

I 



I Operation | Operand 



1 h 

I [symbol 3 1 SETTR | 



Mote: There are no operands. 

Initialization ; fou must preload registers and 1 with the time limit 
in microseconds . 

k DCIISS macro instruction with the PRIVILEGEB option must be coded 
in a CSECT prior to coding SETTR. If more than one DCLASS macro in- 
struction is issued in a module, the last DCIIlSS issued prior to ceding 
SETTR must be issued with the PRIVILEGED option. 



Execution; An entry is created in CHBRTI, 
entry for this task, it will be removed. 



If there was a previous 
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letuira Data : Register 15 is set to OS, meaming noraal return 

SEggP — Set Pser Timer cm 

Tlie SIMW sacro instruction sets tke user timer field in the XTSI, 
thereby limiting four task's execution time. 



I 1 "1 

(lame (Operation! Operand 

I 1 ^-1 ^ 

I [ symbol ] | SI TTU | [ time ] 



time 

specifies the time duration in milliseconds that you want placed in 
the user timer field. 

Specified as s 1 decimal number from to 55361812 or, if the num- 
ber is first placed in a register, in register notation (1 through 
12) . 

Default : It is assumed that the issuer has placed the time dura- 
tion in register 1. 

Initialization ; I BCLASS macxo instruction with the FEIflLBGlD option 
must be coded in a CSSCf prior to coding Sllffff. If more than one DCllSS 
macxo instruction is issued in a module, the last DCl^SS issued prior to 
coding SlfTU must be issued with the wklWTLEQED option. 

Execution: The quantity contained in register 1 is converted to micro- 
seconds and stored in the extended task status index field called user 
timer value (XTSUTI) . 

Example : Issume that register 5 contains the number of milliseconds to 
which you»d like to set the user timer. Tou might write: 

HAIB SETTIJ C5) 

SETUP — Set gp Task Status Index Field fB) 

The SETUP macro instrucrtion permits you to alter or set the contents 
of a selected field in the TSI. 



I 1 -I 

IHame (Operation (Operand 

I 1 ^-+- 



([ symbol] (SETUP ([ field ][ ,register] 



field 

specifies the field you want to set or alter. 

Specified as : One of the codes described below, or, if a value 
€:orresponding to one of the codes (also shown below) is first 
placed in register 15, as (15) • 

USEEID - set the user identification field 
S7SI1 — set the input data set location field 
SIS OUT - set the output data set location field 
SOPH? - operator/ (combined with privilege class-E) 

syst€)m programmer privilege 
SPPII? - system programmer, non privileged 
IPEI? - user 
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COI¥ ~ set the conversational task flag 

ITIFLG - set the intertask message flag 

IFR - set the external priority flag 

lUTH - set the privilege field 

MIV - set the maxiana aaxiliarf storage field 

Field Value 



USEMD 


1 


SYSIl 


3 


SISOOT 


4 


SOPRIf 


6 


SPPKI? 


7 


0P1I¥ 


9 


COM? 


10 


ITMFLG 


12 


IPH 


13 


lOTH 


1% 


HI¥ 


16 



register 

designates the even-odd register pair in which foii have placed the 
information fom want put into the specified TSI field* 

Specified as : The odd register ,► expressed as am absolute expres- 
sion or register notation. 

Initialization : I DCLISS macro instruction with the PlIflLBGlD option 
must be coded in a CSECT prior to «>ding SETUP. If more than one BCLISS 
macro instruction is issued in a module, the last DCllSS issued prior to 
coding SE!PIIP must be issued with the PHIVILEGEB option. 

Execution: From one to eight bftes of registers and 1 are inserted 

into the task status index field specified bj the low-order bfte of 
register 15. The number of bftes to be inserted depends on the field 
specified. 

Field Code Implied length fbvtesl 

8 

2 
2 



OSESID 


1 


SYSIl 


3 


SISOUT 


i» 


SOPRIf 


6 


SPPRIf 


7 


UPRIf 


9 


COM¥ 


10 


ITIFLG 


12 


XPR 


13 


lUTH 


111 


IIV 


16 



2 
1 
2 

Example ; Issuae that registers 12 and 13 contain an eight-character 
user identification. lou might write: 

TEST SETUP IFSEHIB,(13) 



SETPR — Set Up Pnit Record Device fBI 

The SBTUR m.a€rro instruction specifies the configuration for online 

printers and card punches. 
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• 1 1 ^ 

I Wase I Operation | Operand 

I 1 '¥ 



|[syiibol]|SET!Il 

I ■ 



I £dcb address[ ,setup]| parameter 



deb address 

specifies the address of the data control block opened for process- 
ing a data set on a printer or card punch. 

Specified as ; A relocatable expression or register notation. 

Default : Mone 

setup 

specifies the address of the desired fora nnaber for the punch. 
For printers, it specifies the naae of the default region in the 
SYSOCS data set from which all printer defaults (FCB, CHIIl/TRJIIM, 
etc.) aaf be found. 

Specified as : one to six alphaneric characters 

Default : PIPEl. 

parage ter pointer 

specifies the address of a parameter list (which is defined by the 
CHASOl DSICT) which contains the exact specifications for a printer 
setup. This parameter list is in the following format: 



SOHOIG 


DS 


OF 


SUfiDCB 


DS 


A 


S 01 CHARS 


DS 


OC 


S0ECH1S1 


DS 


CL6 


SUBCHA52 


I>S 


CL6 


S0fiCaAB3 


DS 


CL6 


SIJ1CHAR4 


DS 


CL6 


SORFCB 


J>S 


CL6 


SyiDSM 


DS 


CL44 


SORCPDSM 


DS 


CI44 


SOEBORST 


DS 


CL1 


SORBllfER 


DS 


CLIO 


SORCOPIG 


DS 


x 


SURCOPY 


DS 


XLS 


S OR FLASH 


BS 


CL8 


SORFCWT 


DS 


X 


SORFORH 


DS 


CL6 


S OR VXD 


BS 


CL6 


SURFLG 


DS 


X 


SURFLSH 


IQO 


SURFLG 


SORFLSHl 


EQO 


X»80« 


SURDFLT 


IQO 


SORFLG 


SURDFLTM 


IQU 


X»40« 


SIIR¥IB2 


DS 


CL6 


SORLEID 


EQO 


* 


STOL 


EQO 


*-CHASUH 




DS 


2X 




DS 


21F 


SIIRL2M 


EQU 


♦-CHASOE 


Proarammina Botes: 


To ensur 



ADDR OF ISAI DCB 

SfART OF CHARS TO LOAD 

REG HAEB OF 1ST CAT EMTRY 

REG MAHE OF 21D CAT BITRY 

RIG NAME OF 3RD CAT EMTRT 

REQ MARE OF 4TH CAT ElTRf 

FCB REG NAME TO LOAD BY 

FQI OF SYSOCS DS TO USB FOR LOAD 

FQa OF COPY HOD DS 

Y! FOR BTS 

PAPER TO USE ** NET ** 

iO COPIES OF DS 

NO COPIES OF PAGE (OILY 1ST BYTE USED) 

NAME OF FLASH IMAGE 

COUNT OF COPIES TO FLASH 

NAME OF DEFAULT REGION IN DCS 

¥ID THIS JOB 

FLAG BYTE 

0=FLASH MAY OR MAY NOT BE RBQD 

1=D0 NOT FLASH 

0=CHARS PARI FILLED IN BY PRINT CilD 

1=CHARS FILLED IN VIA DEFAULT 

ITERS ION ID OF COPY MOD DS 

CURRENTLY USED LENGTH 

USED FOR ALIGNMENT fSPARE) 
USED FOR ALIGlffBxfT (SPARE) 
LSI OF TABLE 



To ensure a valid setup, the SETUR macro instruction 
should be issued before any I/O operations are directed to a printer or 
punch. This is donci by issuing SETUR immediately after opening a data 
set or after the FINISH macro instruction is executed and the I/O opera- 
tion ccwpleted. 
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Card Punch s The setup for a card piuicli is described by the form utiiiiber 
of the card that the operator is to load into the pimch-feed hopper of 

I the punchy This form nuaber is an installation -defined constant. When 
the macro instruction is executed, the SETOfi routine determines which 
form is mounted in the punch (the currently mounted form number — or 
zeros if the DCB was just opened — is stored for each device in the 
SDITJ m If the desired form is already mounted, control is returned to 
the invoking routine with a return code of 0. If the form is not 
mounted, a message is written to the operator (ITO) to mount the desired 

I form number (6-byte parameter), and to ready the punch. A return code 
of 4 is provided to the calling task. When the operator indicates that 
the punch is properly loaded, by causing a not-ready to ready interrup- 
tion, the SDIT is changed to reflect the new form number. On the next 
call to SlfUE, control is returned to the invoking routine with a return 
code of 0. 

I Printer : if the •deb ad dress, set up" form of this macro is used, the 

I value specified for the setup parameter is used as the index into the 

I SISOCS dataset from which printer setup defaults are obtained. The 

I default region of the SYSOCS dataset must specify FCB, FfiPBB, and print 

I train requirements. 

I then the 'parameter pointer* form of the macro is used, SETUR will fill 

I in any missing defaults based upon the value specified in the SUEFOIH 

I value in the parameter list. In either case, should a required parame- 

I ter not be filled in, SBTOl will issue an appropriate return code. 

Executio n; The SETUR macro instruction returns a code in register 15 
I indicating the manner in which the SETBE call was completed. All return 
codes are defined in Figure 35. 



J J-. 

Return 
Code 



Meaning 



I Operation completed successfully. 

4 I Operation not complete; SBTUR macro instruction should be 
reissued. 

8 I Unrecoverable I/O error occurred while attempting to load the 
device* 
12 J User software error. 
16 I System software error. 
20 I EJE disconnect error. 
24 I Job cancelled. 
28 I Page backup requested. 

lote: for return codes 12 and 16, register 1 will point to a 
prompt parameter list indicating the exact cause of the error. 

I 1 . 1 

Figure 35. Return codes for the SETOR macro instruction 

then the SITUR macro instruction is executed, the routine determines 
if the present configuration of the printer, specified in the SUE TABLE, 
pointed to by the SDAT, is the configuration requested for this SETOR 
call. If the form, carriage tape (FCB) chain/train, etc., are present, 
control is returned to the invoking routine. If the desired configura- 
tion is not present, the system acts to achieve the desired 
configuration . 

SETOR uses the SISOCS data set to build the necessary blocks to load a 
printer configuration. The SYSOCS data set used may or may not be user 
specified. If defaulted, SBTOl uses the system owned SYSOCS data set 
TSS***'i^.STSOCS (0) ; this data set contains all the information needed to 
load the 1403, 3211, and 3800 printers. 
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S YSOCS : tkis data set is a region data set coasistiag of 4 Msic 
regions. Bach region name is 8 bjtes long, the first two bytes of which 
are predefined by the system. They are as follows: 

1. CltXXXXX — character arrangeaent table region. This region contains 
the inforaation needed to load the OSCB in the 3211 and 1403 printers, 
and the translate tables and WCGHs in the 3800 printer. For the 3800 
printer, it may also contain the naae (s) of graphic modification 
regions* A aaxiniiii of 12 naaes nay be specified. 

2. FBXXXXIX — format control buffer region. This region contains the 
information needed to indicate which density and carriage control tape 
are needed for the 1403 printer, and the FCB specification and density 
settings for the 3211 and 3800 printers. 

3. GFXXXXXX — graphic modification region* This region the pictnre 
images needed to built graphic modifications for the 3800 printer. All 
the standard IBH graphic modifications are in TSS*»**^.SYSGSAPH (0) . 

4. standard setup region. This region contains the default information 
needed for a standard printer setup* It is also used to backfill any 
setup information reguired but not specified. 

Example 1 ; the example that follows contains the information needed to 
load the 3211 and 3280 printers with the P11 chain/train configuration, 
this is indicated by the D1¥IC1=321 1/3800, HJkEE=P 11 statements. The load 
information immediately follows this statement (s) . In the case of the 
3211 it is the chain/train image. For the 3800 it is the translate ta- 
ble followed by the iCSM IB. This example does not define the P11 train 
image for the 1403. However, it does indicate where this information 
may be found* The statement I>EVICE=1403,SBE=(P1,1403) indicates the P11 
compatible 1403 chain/train image may be found in the region CTPM of the 
SISOCS data set. 
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CfPl 

CTFI 
CTP1 
CI^PI 
CTPI 
CTP1 
CfPl 
C1?P1 
CTPl 
CTPt 
CTPl 
CTPl 
CTPl 
CTPl 
CTP1 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTPl 
CTP1 
CTPl 
CTPl 
CTPl 



0000100 
0000200 
0000300 
0000350 
OOOOilOO 

oooonso 

0000500 
0000550 
0000600 
0000650 
0000700 
0001000 
0001100 
0001200 
0001300 
0001400 
0001500 
0001600 
0001700 
0001800 
0001900 
0002000 
0002100 
0002200 
0002300 
0002400 
0002500 
0002600 
0002700 
0002800 
0002900 
0003000 
0003100 
0003200 
0003300 
0003400 
0003500 
0003600 
0003700 



DB?IC1=1403 

D1VIC1=3211 

1»BDJL-5K*C 

I'BDJL-SK't^C 

1»BDJL-5K*C 

1«BDJL--5K*C 

1«BDJL-5K*C 

1«B1>JL-5K*C 

1«BDJL-5K*C 

1«BDJL-5K*C 

EMB 

DEfICE=3800 



,SlE=(Pir^ 
^NAIB^PII 
(lIJia=BO?) 
(HOf=B:#> 
(NAa=lO?) 
(lfO$=S:#) 
(IIAS=BO?) 
(liO$=E:#) 
(HI1=E0?) 
fNO$=B:#) 

t!IIII2=P11 



1403) 

S-.#1>V92«»68<XYT|GF16H. 
SlSRZT9-^G682;irT<XF%H, 
S-^#H>?92"68<XYT |GF«e, 
SIS12f9-^G682;YT<XF1le< 
S-^#1>V92"68<XIT I GF«H . 
SASHZV9+G682 ;TT<XF«H . 
S-.#E>f 92"63<Xf T IGFSH , 
SASEZ?9+G682 ;XT<XF%H . 



,_a07/P3iHIQ,4 
._0O7/P3iMIQ,4 
._007/P31MIQ,4 
._007/P3IIEIQ,4 
._U07/P3iMIQ^4 
._lI07/P3iHIQr4 
._007/P3WMIQ,4 
._007/P3fMIQ|.4 



Exaaple 2; 



FBSTB6 
fBSTD6 
FBSTD6 
FBSTD6 
iBSTD6 
FBSTI>6 
FBSTD6 
FBSTB6 
FBSTD6 



0000100 
0000200 
0000300 
0000400 
0000500 
0000600 
0001300 
0001400 
0001500 



TEAMSLkTE TIBLB 

FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
FFFFFFFFFFFF#FFFFFFFFFFFFFFFFFFF 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
FFFFFFFFfFFPFFFFFFFPFFFFFFFFFFFf 
OOFFFFFFFFFFFFFFFFFFFFOBOCODOSOF 
lOFFFFFFFFFFFFFFFFFFFFlBlClDlBlF 
2021FFFFFFFFFFFFFFFFFF2B2C2D2E2F 
FFFFFFFFFFFFFFFFFFFF313B3C3D3E3F 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF 
IFO 10203040506070 809FFFFFFFFFFFF 
FF1 11213 1415 161713 19FFFFFFFFFFFF 
FFFF2223242526272829FFFFFFFFFFFF 
303 13233343 536373 839FFFFFFFFFFFF 

ICGJ PURS 

C82,00) 

GEIPHIC MAilS MAX 12 

EMD 



DE?ICE=1403 

FOHaAT=STANDAK0^6 

END 

DE?ICE=3211 

F0HMAT=1 (6^1) ,62(6^12) ^66(6^9) 

EHB 

DB?ICE=3800 

FOfiMAT=l (S, 1) ,.62(6,12) ,66(6,9) 

END 



The "DE?ICE=» keyword signals tke start of the device dependent informa- 
tion. For the 1403 the operator will be requested to iiount the carriage 
tape ■STAID AID* and set the printer density to 6 lines per inch (LPI) . 
For the 3211 and 3800 an FCB image setting the density to 6 with channel 
code 1 at line 1, channel code 12 at line 62, and channel code 9 at line 
66 will be built. 

Exaaple 3; 

STPAPEE 0000200 PAPEE=1PL1 
STPAPER 0000300 F0SMAT=STD6 
STPAPER 0000400 CflARS=F1 1,H1 1 
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I ThB default region of tke SfSUCS data set is used bf botli tke SEtUE 

I process aai tke print coaaand. SETHI usbs ttis region to backfill 

I defaulted values in tke SBTOP request • The print coiaand mses it to 

f fill in defaulted values in the batch work queue. This information is 

I used hj tke batch monitor to schedule print Jobs on the correct printer. 

I At print request time the ■CHIRS=* keyword indicates that either a Pll 

f or Hll train iaage can satisfy the print request. At SBfOfi time the 

I *CH11S=« keyword indicates that the F11 train iaage should be loaded in 

I the printer. PIPEfi type is IPLY regardless of printer type. l*he region 

I FBSTB6 will be used to fulfill the FCB requirements based upon device 

I type. 

I Exaaple 4: 

I In the example that follows two picture iaages have been defined. Both 

I pictures will have a pitch value of 10 as indicated by the •PITCH=» key- 

f word. The keyword ■C0D1 = * defines tiie displaceaent into the translate 

I table where the graphic Modification is to be placed. I aaxiauii of 2% 

I picture images nay be specified in a graphic Modification region. The 

I first line of each picture iaage must specify the code and pitch value. 

I The secx>nd line^ in the above example, is optional and is used for ref- 

I erence purposes onlf . Each picture image laust have 24 lines. The sys- 

I tem will accept a aaximua of 18 characrkers per line. Short lines will 

I be padded to the right with blanks ^ long lines will be truncated. 



S€sction 2: Systeii Macro Instruction Descriptions 207 



GFGIFI 
GfGBFl 
GFGRF1 
GFGBF1 
GFG1F1 
GFGRF1 
GF31F1 
GFGIFI 
GFGHFl 
GFGIFI 
GFGBFl 
GFGBFI 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGfif 1 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGfill 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 
GFGBFl 



0000100 
0000200 
0000300 
0000400 
0000500 
0000600 
0000700 
0000800 
0000900 
0001000 
0001100 
0001200 
0001300 
0001400 
0001500 
0001600 
0001700 
0001800 
0001900 
0002000 
0002100 
0002200 
0002300 
0002400 
0002500 
0002600 
0002700 
0002800 
0002900 
0003000 
0003100 
0003200 
0003300 
0003400 
0003500 
0003600 
0003700 
0003800 
0003900 
0004000 
0004100 
0004200 
0004300 
0004400 
0004500 
0004600 
0004700 
0004800 
0004900 
0005000 



C0I>1=5B PITCH 10 
123456789012345678 



*♦* 
♦lit* 
♦ *♦ 

mm* 
*** 

*♦* 



mmm 

mm* 
mm* 



mmmm***m**m 
mm******* 



C0I>E=7B PITCH 10 
1234567890 12345678 



mm* *** 

mmmmm m**** 

mmm *** 

mm* 

*** 

mmm *** 

mmm *** 

mm* *** 

mm* *** 

mmm *** 

mm********* 

mmm******** 

*** *** 

*** *** 



SETVLQCK — Set VM Lock (O) 

SETfLOCK is used to set a fH Lock, 



I 1 1 

I Mane | Operation | Operand 



([symbol ] I SITVLOCK flock^og [^SET=set] 
I 1 I 



lock 



specifies the VH Lock to be set. 
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log 



set 



Specified as : an EX adiress. 

specifies the fl Lock Inclior to be used to record the status of tke 
spe cif ied lock » 

Specified as : the syabol namiEg a LOGfLOCK macro. 

specifies aa address in the current Module to be branched to if the 
specified lock is already marked ••set". 

Specified as : an II address. 

Default : fhe status of the lock will not be checked. 

Execution: If the branch address is specified and if the fH Lock Anchor 
indicates "set" the branch will be performed. Otherwise^ the specified 
¥M Lock will be set and the fM Lock Count (ISIfLKCTJ in the task's 
Interrupt Storage Area (CHAISI) WILL BE IICESMBHTED. !fhe address of the 
lock will be saved In the ?1 Lock Anchor for use by OPIfLOCK, etc. 

CAOTIOl: tehis macro must be protected from task interrupts by I1?I/PTI. 

Programming note : lefer to ?i Locking in Section 3. 



SETTB — Set External Page Table Entries fBI 

The SETXP macro instruction allows a range of virtual storage to be 
associated with a set of external storage addresses. It also flags 
pages as "unprocessed by dynamic loader." The first reference to the 
page or pages will then cause control to be given to the dynamic loader. 

J 1 " »■ ' " 1 ■ ' ^ ' ^ — I 

IMame | Operation! Operand | 

I 1 1 ^ ^ ^ 1 

I [ symbol ]| SETXP i f 

I I II . ^ . I 

Mote : There are no operands. 

Initiali zation : A BCLASS macro instrucrtion with the PlIVILEGED option 
must be coded in a CSECT prior to coding SETXP. If more than one BCLASS 
macro instruction is issued in a module, the last BCLASS issued prior to 
coding SETXP must be issued with the PRIFILEGBB option. 

Execution: The first bit of the halfword immediately following the SVC 
is interpreted as a flag. If this bit is 1, the high -order bit of the 
SBA indicates which entry has been processed by the loader. The maximum 
page count is 1022- The low-order 10 bits of the halfword following the 
SWC are interpreted as a page count. The first fullword following the 
S?C contains the virtual storage address at which the external page ta- 
ble entries are to be set. After this word — and depending on the page 
count — are a number of words; each word contains an external storage 
address that is to be associated with a page in the virtual storage 
range. If the unprocessed-by -loader flag is set for a page, the first 
reference to that page by a program causes cxintrol to be given to the 
dynamic loader via a task-program interruption type 16. 

The external page table entries supplied in the parameter list are 
set as indicated. The unprocessed-by-loader bit is set for each page 
whose bit string flag is a 1 and the high-order bit of the SBA is zero. 
This allows a mixed list to be processed* 
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Retmrn Data : lo&e* 

Bxaaple ; Suppose that yom want to set external page table entries for 
three pages beginning at location MEW. Yon aight write: 



SIIPL 


IX 


a,SET 




B 


SOIBPLICE 


Slf 


DS 
SETXF 


Of 




DC 


H»3» 




DC 


A (MBi) 




DC 


H«12« 




DC 


H«115« 




DC 


H»35» 




DC 


H«51» 




DC 


H«12» 




DC 


a»3«»»' 



SVC MOSf BE OM POLL WOBD BOOMDART 

MO BIf STIIIG, THIEE PAGES 

ADD EXTEIMAL PAGE TABLE EMT AT MEW 

SYHBOLIC DEflCE MOHBEE 

RELATIVE PAGE 01 DEVICE 

SYMBOLIC DEVICE lOMBBR 

RELATIVE PAGE OM DEVICE 

SYMBOLIC DEVICE MJMBER 

RELATIVE PAGE OM DEVICE 



SETXTS — Set Pp Extended Task Status Index Field (Rl 

The SETXTS macro instruction enables jon to set the estiaated run 
time of yonr task in the XTSI. 
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J J , — p ^ ^ 

(laae | Oper a ti on | Operand | 

I 1 _| ^ ^ 1 

|[siBbol]|SETXTS |[ field] I 

I I ^. — I ^ 1 

field 

specifies the XfSI field to be set. 

Specified as s ISTIH^ whick indicates tkat tlie estimated run -time 
field of the XfSI is to be set; SBT2i|^ vbick indicates 24-bit ma- 
chine addressing is to be used; or, if the decimal value of 3 (for 
1ST II) or 12 (SBf2i|) is first loaded into register 15, as: (15) . 

Default: It is assumed that the issued has placed a value in 
register 15. 

Initialization : li DCLISS macro instruction with the P1I¥IL1G1D option 
must be coded in a CSECT prior to coding SBTXfS* If more than one 
BCLASS macro instruirtion is issued in a module, the last BCLISS issued 
prior to coding SETXTS must be issued with the PlIflLEGEB option. 

Execution ; The value in registers and 1 when SETXfS is issued is 
stored in the extended task status index field indicated by the code in 
register 15 . 

Example : Suppose you want to set the estimated mn-time field of the 
extended task status index, fou could write: 



SI 


0,0 


L 


1,=F» run time" 


SETXTS 


ESTIl 



l&HE 

SIPEHOQK — System Performance Evaluation 101 

The SIPESOOK macro instruirtion is assembled into various resident su- 
pervisor modules so that system data may be collected by the System 
Internal Performance Evaluation Module (SIPE) 

, 1 —^ ^ ^ — ^^^ . 1 

I lame | Operation {Operand | 

I , _| ^ ^ ^ 1 

{[symbol fSIPEHOOi: )number-value,hook€:ode-value | 

I 1 . — I ^ . I 

number 

specifies a unigue number for this SIPEfiOOK within this assembly 
module. 

Specified as : a two digit decimal number. 

hookcode 

specifies which SIPE cx^llecrtor is to be activated because of this 
hook. 

Specified as : a three digit decimal number. 

Execution : The action that occurs when a hook is reached is actually 
determined by the setting of an instruction switch located in the pre- 
fixed storage area (PSI) of main storage. (PSI is the term used to 
describe main storage locations 0-4095, which can be addressed without a 
base register.) . When TSS startup is completed, this instruction switch 
contains a lOPl instruction (acrtually, a two-byte BCl isntruction, with 
condition code 0) . 
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flieii control arrives at a hook, this central switch is the subject of 
an IXECUTE instruction. If SIPE is not being useiL, the 10 FB instruction 
is executed, and control flows through the hook, lowever, if SIFl is 
active y the initialization phase of SIPE has reset this central switch 
to an SVC. This SfC is executed bf the hook and results in a transfer 
of control to SIPS, which recognizes the SIC code as denoting hook 
execution. Basically, the following events occur for a selected hook: 

1. fhe hook is entered, executing the switch in the PSA region 
(SVC) . 

2. The hardware-stored S¥C old PSl contains the c^urrent machine sta- 
tus and the instruction counter. 

3. The SfC new PSW becomes active. 

(a) SIPE saves all machine registers. 

(b) SIPE locates the hook via the SVC old PSl {instruction count- 
er) and inspects the hook identity code (a constant included 
in the hook) • 

(c) A collector is given control to abstract the appropriate data 
for this hook and file it in the output buffer. 

(d) The I/O buffer is output if necessary. 

5. The machine registers are restored. 

6. The SfC old PSl is loaded, returning control to the host module 
at a point just past the hook. 

Example ; Suppose SIPE collector 115 is to be airfcivated in a supervisor 
module. The macro instruction might be written: 

SIPEHOOK 01,1i»5 

This would generate: 

EX 0,PSISIP 
MOP *-* 
OSG *-2 
DC 111(145) 
BC 111(255) 



STORE — Store Register Contents fOI 

The STORE macro instruction stores the contents of one or more 

registers. 



I lame | Operation! Operand 
-f 1- 



I [ symbol ]| STORE | area, (first register[ ,last register ]) 



area 

specifies the address of the storage area in which the register or 
registers are to be saved. 

Specified as : An RX address, or register notation. If register 
notation is used, the address must first be loaded into the speci- 
fied register. 
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first register 

specifies the first in a range of registers wliose contents are to 
be saved, or the onlf register wliose contents are to be saved • 

Specified as ? I decimal number from 8 throngh 15, 

last register 

specifies the last register in a range of registers. 

Specified as ; I decimal number not greater than 15. 

Default : Only the register specified in the first register operand 
is saved. 

Programming Motes ; The area must be large enough to contain the speci- 
fied range of registers. 



STITB — SET and ITECT Table 

The STXTE is a macro used for generating internal tables for use by 
the three SET/XTICT rontines — CEAEl, CEIS2, and CBiS4. 

J 1 . — ^ ^ — 1 

I name | Operation I Operand | 

I 1 _| ^ ^ ^ 1 

I [ symbol ]|STXT1 I table, field, type I 

I 1 . — I ^ ^ ^ 1 

table 

specifies the name of the dsect which is nsed in each particular 
routine . 

Specified as ; CHITSI for CE1H2 
CRISIS for CBIS2 
CHIXTS for CEISII 

field 

specifies the field within the dsect which is to be SETup or 
XTlCTed. 

Specified as ; any field within the particular dsect used. 

type 

specifies whether the field can only be XTlCTed or also SETup. 

Specified as : SETUP - setup or extracted 
XTBCT - extracted only 

Programming Notes ; The table generated is in a standard form that the 
SBT/XTICT modules interpret to perform the correct movement of data from 
virtual memory to the corresponding supervisor tables. 

STSEB — Indicate Hon resident-Program -Detected Error fOl 

The SYSEB macro instruction is the means by which a nonresident pro- 
gram reports errors it has detecrted. 

I 1 ' — I ^ ' 1 

I Name | Operation {Operand | 

I 1 _| ^ ^ 1 

I [ symbol ]|S1SEB terror type, fillin,id1,id2,id3, call | 

I 1 . — I . 1 
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M2 



±m 



call 



error tf pe 

specifies the type of error detected • 

Specified as : One of the codes skowii in Figure 23 under tlie BllOl 
macro iastmction • 

filliii 

must be included for coapatibility • 

Specified as : Inf two-digit decimal number in the range 00 tbrongh 

27- 

idl 

is the first of three nnifiie identifiers for the message to be is- 
sued when SI SEH is invoked* 

Specified as : I decimal number in the range 1 through S3, 

the second of three nnigne identifiers for the message to be issued 
when SYSll is invoked. 

Specified as : I decimal nnmber in the range 1 through 99- 

the third of three nnigne identifiers for the message to be issued 
when SISEl is invoked. 

Specified as : I decimal mnmber-in the range 1 through 999. 

is used to identify one of several calls in a module* 

Specified as : I decimal number from 1 through 99. 

Initialization : I BCLISS macro instruction with the PlIflLBGlB option 
must be coded in a CSECT prior to coding STSll. If more than one BCLISS 
macro instruction is issued in a module^ the last DCLISS issued prior to 

coding SlSEl must be issued with the PIIVIIBGBB option- 

Execution : The processing unit receiving the SfSER S?C stops all other 
processing units in the system • .1 message fsee ••SlSBl DOIF" in Section 

5) is issued at the operator's terminal^ the system enters the wait 
state, and, at the installation's discretion, a dump is taken • 

If the error type is 2 (major software), a program interruption 202 
is fueued on the calling task; this ultimately results in its abnormal 
termination. If the error type is 3 f^^^^^^^ii^^ failure) , the S¥C 228 
routine transfers control to the recovery nucleus. If the error type is 
1 fminor software) , or if the recovery nucleus returns control to the 
SfC 228 routine, all other processing units in the system are restarted; 
control is then returned to the instruction following the SlSEl parame- 
ter list* 

ProciramBincy Mote : Fart of the message issued at the operator's terminal 
is a nine-digit SISEl code; this code is formatted from the idl (aa) , 
id2 (bb) , id3 (ccc) , and call (nn) operands of the SYSEl macro instruc- 
tion and has the form aabbcccnn. This construction permits you to iden- 
tify calls to the system error processor from privileged virtual storage 
modules to facilitate debugging. lou might, for example, assign a par- 
ticular idl code to a group of related modules, assign a particular id2 
code to a subset of this group, and a particular id3 code to a module or 
group of modules within this subset; such an arrangement would identify 
the source of the call to the system error processor, lou could then, 
using the call operand, assign sequential numbers to the SYSER calls is- 

212 



siiad by tkat Bodiile or group of Molmles to aid recognition of particular 
errors resulting in calls within the sequence. For example, jon sight 
write: 



, iti 

I t ia2 

I I , ^a3 

I I I ^ call 

SYSll 1,00,13,6,99,1 

ant the resulting SfSll coie, 130609901, wonli identify the error which 
resulted in the call to the system error processor. 

To avoid the possibility of issuing different SlSEl calls with the 
same SfSBl code (thus duplicating the messages issued at the operator's 
terninal and creating confusion as to the reason for the call) , see Sys- 
tem Messages for those SlSSl codes already in use in the system. 

Example : Suppose your task detects a minor software error and you want 
to get just the basic SfSH output. Ton might write: 

BOG SISll 1,00,2,0,23,01 

TSEHB — Forc^ Time Slice End fll 

The TSEID macro instruction forces on your task an early time slice 
end. 



I 1 ^"T ' • 

IVame (Operation (Operand 

I- 



I [symbol] I TSEID f 

I I I- 



Bote ; There are no operands. 

Initialization : A BCIISS macro instruction with the PlIflLSGBD option 
must be coded in a CSECT prior to ceding TSEIB. If more than one DO. ASS 
macro instruction is issued in a module, the last BCI.ISS issued prior to 
coding TSEID must be issued with the PIIVIIEGED option. 

Execution : The current time slice of the task issuing the S¥C is 
terminated. 

Example : If you want to cause your current time slice to come to an 
end, you might write: 

11% TSEID 

TSTflQCK " Test fM lock fOI 

The TSTTLOCK macro is used to test the recorded status of a ¥1 lock. 



I lame | Operation (Operand 

I 1 J. 



I [ symbol ] I TSTVLOCK (log,[ set ],[ open ] 

I 1 —I 



log 

specifies the ¥1 lock to be tested, 
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Specif iei. as s the sjDbol namiiig a LOGfLOCK nacro* 

set , open 

speciff addresses lit the current modiile to be branched to i£ the 
lock is marked "set* or ••open"^ respectively. 

Specified as ; IX addresses. 

Execution : The specified VH Lock Anchor is tested^ and the appropriate 
branch is executed. 

Proaraattina ; lefer to ▼! Locking in Section 3. 

fW&If — Wait for feminal 1/0 Interruption fRI 

fhe flllT macro instrncrtion checks for a response to a message yon 
have sent and^ pending its arrival, puts fonr task in the delay state, 
which causes your task's pages to be moved to auxiliary storage. 

I 1 1 ^ 1 

I name | Operation | Operand I 

f_ 1 1 1 

|[symbol]ITiIIf | I 

I 1 1 1 

Mote: There are no operands. 

Execution : The S?C must be the subject of an Execute instruction and 
must occupy the second halfword of a fullword control block called an 
event control block (ECB) . The resident supervisor checks the second 
bit of the halfvord preceding the supervisor call and interprets this 
bit as the event complete bit. If this bit is 1, the supervisor returns 
control and the S?C is in effect a lOF (no operation) . If the bit is 0, 
and there are any unmasked interruptions gueued on the task, a HOP is 
also affected. Otherwise, the supervisor sets the TfllT flag in the 
task's TSI to 1 and puts the task in the delay state j this causes time 
slice end to occur for the task. The task is removed from the delay 
state when any task -interruption — if the task is enabled — occurs. 

Example : Suppose you send a message to some terminal and are waiting 
for a response. The posting routine associated with the lOCAL (see the 
lOCAL macro instruction) used to transmit the message to the terminal is 
responsible for setting the event-complete bit of an event control block 
to 1. lou have reached a point in your program beyond which you do not 
wish to continue until the lOClL posting routine has been entered. You 
might write: 



TEST 



OFLOW — User Flow for TSS and MTT fRI 

The UFLOl macro instruction is used (for example, by the FLOW 1:0 mm and 
processor) to modify or obtain either the conversational task limit and 
the number of current TSS users, or the multiterminal task (RTT) appli- 
cation user limits and the number of current users £or each application. 



El 


0,TEST-i"2 




B 


lOCOHPLETE 




DS 


OF 


ALI6V 


BC 


H»0» 


POSTIWG FLIGS 
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-I ^— 1 ^ — " 

I Operation {Operand 



llaae 



I 1 -h 

|[sfBboll|DFI,01 I 



Bote s There are no operands (see Initialization) • 

Initialization : Before ezecnting this aacro instmcrtion, registers 1 
and Bust be loaded vitb tke following parameters: 

legister 1 

In action code, speciffing the action to be taken. 

Code Heaninq 

1 Set the conversational task limit to the value specified in 
the low-order two bytes of register O. 

2 Obtain the number of conversational tasks cnrrently in 
execution and the conversational task limit (see leturn Data 
below) • 

3 Set ITf user limits for each of the application names speci- 
fied im the input buffer that is pointed to by register 0* 
The input buffer must contain: 



7 8 



9 10 11 12 13 1il 15 



"T ^ — f 

IHTT 

I user 
I limit 
1(1) 



Ipplication name (1) 



Application name (2) 



I ITT 
fnser 
I limit 
1(2) 

4 



etc* 



The application name must be left-aligned and consist of up 
to eight alphameric characters; the first of which must be 
alphabetic. Setting the application name to X*FP« indicates 
the end of the buffer list, for both acrtion codes 3 and 4. 
The MTT user limit mmst be specified in binary. The low- 
order bytes that are not nsed must contain blanks. 

4 Obtain the number of ITT users in execution for each appli- 
cation name that is cnrrently active in the system, legist- 
er must contain the address of a virtnal storage buffer 
into which the application names and the statistic^s pertain- 
ing to each can be recorded when the regnested processing is 
performed • 

legister 

Either the conversational task limit, representing the total number 
of TSS users that may be logged on concurrently, if airtion code 1 
is specified, or a virtnal storage buffer address, if action code 3 
or 4 is specified. 

The task limit that is specified in the two low-order bytes does 
not affect usc^rs that are already logged on. If set to zero, no 
additional users may logon to TSS; the maximum must always be less 
than or egual to the syst^i maximum. Any virtual storage address 
that is specified should point to a buffer that starts on a page 
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boQUdarj and does not exceed a page lengtk.. This address can point 
to either an input buffer (see action code 3) or to an output buff- 
er (see action code 4J . Two sjstea DSlCTs, ClIOFL and CHIOFI, 
respectively, are available within TSS for use in referring to 
fields in those buffers. 

I DCL&SS macro instruction with the FlIflLEGED option wust be coded 
in a CSECT prior to coding OFLOff. If more than one BCLASS macro in- 
struction is issued in a module, the last BCLASS issued, prior to coding 
QfLOl, must be issued with the PlIflLlGBD option. To ensure (for action 
codes 3 and 4) that the buffer will be in main storage when UFLOl is 
executed, an HfC instruction must immediatelj precede the UFLOl macro 
instruction . 

CAPTIOMS ; Use of UFLOl (which produces an SVC 187) is restricted to 
tasks having sj stem programmer authority (O or P) . Iny virtual storage 
buffer that is provided must not go over a page boundary. 

Execution z The privilege specified by the DCL&SS macro instruction is 
verified. If acceptable, the action code is validated. For action 
codes 1 and 2, the appropriate limit field, conversational TSS task 
limit (action code 1) , or the ITT application user limit (action code 3) 
is set in the multiterminal status control block (HTSCB) . For action 
codes 3 and *», the requested statistics (current number of conversation- 
al TSS tasks or current number of ITT users on a specified ITT applica- 
tion) and the system maximums for such limits (see Programming lotes) 
are recorded in the buffer. AH error conditions are identified by re- 
turn codes or, for action code 3, in the original input buffer (see Re- 
turn Data below) . 

Return Data : 

Register 

For successful execrution of action <:odes 2 and 4, contains the re- 
quested TSS or ITT statistics in the form: 

For action code 2: 



15 16 



31 



T- 



I Current number of 
I conversational tasks 



I Con versational task limit 

f 

J 



For action code ft: 
7 8 



9 10 



11 12 



13 1ft 15 



1 1 1 r 

IppULcation name (1)| Current HTT|User limit| Maximum number 

I users I I of users 



+ 



+ 



+ 



Application name (2) {Current HTTIUser limit|Haximum number 

{users I I of users 



etc. 



The application name must be left-aligned and must consist of up to 
eight alphameric characters, the first of which must be alphabetic. 
Ihen the application name field contains hexadecimal Fs, it indi- 
cates the end of the output buffer list. The low -order bytes that 
are not used contain blanks. The current ITT user value, the ITT 
user limit, and the maximum number of HTT users are all binary 
values. 
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For action coie 3: register poiats to tlie input buffer aM maj 
coataia error iadicatioas: 

1. If aa applicatioa aa«e is noaexisteat^ the two kalf words start- 
iag at bjte 10 ia tlie iapat buffer are set to X»FFFF». 

2m If the BaxiBUB allowable user limit (recorded ia IfSEIl ia tke 
HTSCB) is exceeiedr tbe two bal&ords startiag at bjte 10 ia 
tke iapat buffer are set to €»*♦•', aai the ®axi«ii« value is 

placed ia the aext half word (at bjte 1*1). 

legister 15 

Coataias a retura code: 

Code Meaaiacf 

normal cospletioa 

4 Coaversatioaal task limit is larger thaa maximum value 
(ETSRIl) for actioa code 1 

8 Ictioa erode specificatioa error 

12 Buffer exceeded page bouadarj 

Proqrammiaci Motes s The iaitial TSS coaversatioaal task limit is estab- 
lished duriag system geaeratioa with the TSKLIT macro iastructioa (see 
System Geaeratioa aad Haiateaaacel ; the aumber of HTT admiaistrators (or 
ITT tasks) is iacluded ia the cx>uat of coaversatioaal tasks. 

The u^r limit specified for each ITT applicatioa program with OFLOW 
caa aever exceed the maximum value origiaally established by the ITT 

admiaistrator whea he issued aa HTT commaad* 

Before OFIOW is first issued, a GITIIII macro iastructioa caa be is- 
sued to get the buffer, which i^u be retaiaed for the duratioa of the 
task. 

If a coaversatioaal TSS task eads abaormally (completioa code 2) , a 
aew task is created regardless of the «>aversatioaal limit. 

I commaad, FLOW, available oaly to system maaagers, admiaistrators 
(see Maaagers aad Admiaistrator *s Guidel , aad operators (see Operator's 
Guidel , caa be used dyaamically to modify the aumber of coaversatioaal 
or batch tasks. 



PPDTOSEB — gpdate Pser Tables CO) 

The IPDTPSll macro iastructioa causes the data pertaiaiag to exteraal 
storage that is curreatly ia each user table ia the SfSOSE data set to 
be updated with iaformatioa from the various user catalogs aad DSCBs. 

I 1 "^ ' • ^ ^ — — — — -~ — — — ^ ^ — ^ , 

IVame | Operation (Opera ad | 

I 1 ^ _ . ^ ______ ^ 1 

|[symbol]|OFDTIISBl |[mode] | 

1 1 ^-1 »_ — ^ ^ _. ^ ^. I 



mode 



specifies whether all or select user eatries ia the SlSPSl data set 
are to be updated. Select users are those users with curreatly ac- 
tive tasks aad those users owaiag shared data sets that are cur- 
reatly beiag accessed. 
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Specified as : I - all 

S - select 

Default ; I 

Initialization i 1 DCLISS Macro instruction vith tlie PEIflLESBD option 
Bust be coded in a CSECIf prior to issuing OPDTIISEB. If more than one 
DCLASS aacro instruction is issued in a nodule, the last BCLISS issued 
prior to eroding OFDTUSll aust be issued with the PRI¥1LS6ED option. 

Execution: tJPDTUSEB updates the cuBulati^e page count fields in the 
user table data set (S7S0SE) bj extracting the infornation from each 
user's catalog and each referenced data set's for»at-B DSCB. Teaporarf 
public data sets are erased, the total nuaber of pages assigned to each 
user table is changed to reflect the values indicated by their DSCBs^ 
and the temporary and external storage allocation fields are updated. 

If mode S is specified, only those entries whose users were active at 
the time of issuing UPDTUSEB (or, if the system failed and was 
restarted, users who were active at the time of system failure) are up- 
dated. ("Ictive"* here means active task or with a shared data set that 
was being read, fhe flag OSSikDC in the user entry indicates an airtive 
user.) 

Return Data : 1 message signifying the iximpletion of the update is writ- 
ten to SI SOOT, a return code is placed in register 15, and control is 
returned to the issuing program. 

Return Codes Meaning 

00 Sormal return 

0^ DSCB error or improper authority code 

Example : A privileged system programmer has previously issued an RFS or 
C¥? command, or has decided that many user tables have become obsolete. 

User: UPDTUSBR 

System : Returns the following message to SISO0T: *nnnn USER TABLE 
STORAGE ALLOCATIOIS UPDATED AGAIHST DSCBS.«» 

Programming Motes : Following an RFS or C?¥ command, an UPDTUSER command 
or macro instruction should always be issued. UPDTUSER may be issued 
without a preceding RPS or CVV. 

UPDTUSER facilitates the conversion from an old user table entry 
DSECT to a new one. 

If the user table is suspected or known to be in error, issuing UPD- 
TUSER causes the current catalog and DSCB information to be placed in 
the user table. 

If the user table is up to date except for active users, which may be 
true following a system failure and restart, the use of mode S speeds 
the updating. 

Any temporary public data sets are deleted by issuing UPDTUSER - 

When the user table of the task issuing UPDTUSER is itself updated, 
the shared virtual storage of that user table is updated to correspond 
to the updated SYSUSE record. 
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PSAgB " DisplaT Resource Psaqe fSI 

TMs aacnro instmctioii obtains aecountiEg data that has been acci»ii- 
lated for a user. 

USIGS is described in Asseabler User Macro Imstructions # except for 
the folloving inforaation that is applicable only to sjstea programmers 
(authoritf codes O or F) • 

aserid 

specifies the address of a location csontaining the Qserid of the 
user for whom the accounting data is regnested^ (i nonprivileged 
user ma; obtain onlj his ovn accounting data; a system programmer 
may obtain the accounting data of any user.) !Phe nserid at the 
specified location most contain one to eight alphameric characters, 
the first character must be alphabetic, and the nserid must be 
delimited by 1»27». 

Specified as ; I relocatable expression, or, if the address is 
first loaded into the specdfied register, in register notation. 

Default : The issuer's userid will be used. 

OSIEOCK — Lock Pser Table Entry fOI 

The OSELOCK macro instruction is used to lock the virtual memory copy 
of a user table entry. 



I 1 -T 

I lame | Operation | Operand 

I 1 -I 

I [ symbol ]| USILOCE | 

I I —I 



Mote ; There are no operands. 

Initialization ; The program issuing the USELOCK macro must have previ- 
ously set up base registers for task common (CHITCH) and the user table 
entry (CHJlllSE) . 

Execution ; The USILKCIT is loaded into general register 15 to control 
the number of time slicse ends that will be issued. The lock byte is 
then tested with a TS instruction. If successful the task id is mowed 
from task common to the user table entry and processing continues. If 
the TS instruction was unsuccessful, a time slice end is issued, the 
count in general register 15 is decremented, and the lock byte is tested 
again, then the count goes to zero, processing €;ontinues as if the TS 
instruction had been successful. 

VBHEB — VAH Data Management Error Secovery fS) 

The VDlEl macro instruction provides an error exit for attempting 
recrovery or issuing diagnostic messages when error conditions arise 
while pro€:essing VIH data sets. If used conversationally, VDREl issues 
diagnostic messages and returns to the user's terminal without termi- 
nating his task. If executed nonconversationally, diagnostic messages 
are written to the SfSOUT device, and the task is terminated. 

Standard form; 

I 1 ^-1 ^ • 1 

flame {Operation {Operand | 

I 1 ^ ^ ^ ^ , 

|[symbol]|VDHEl |dcb address, message id, flags | 

• 1 -I ^ . I 
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Is- and l-forns: 



T 1- 

llane (Operation (Operand 



I 1 1 ^ 

|[sjBbol]t?l>lllB |dcb address, message id,flagSrEF=p,( (l,list)} 

I I I 



Mote ; K symbol is required in the name field of the L-form. An operand 
omitted from the L-form must be specified in the B-form; an operand 
specified in the L-form is overlaid by the same operand in the 1-form* 

deb address 

specifies the address of the data control block (DCB) for the data 
set in error • 

Specified as ; I relocatable expression or register notation (2 
through 12) . If register notation is nsed, the address mast first 
be loaded into the specified register* 

message id 

specifies the address of the second word of a parameter list that 
contad.ns the identificration number of the diagnostic message for 
the error condition. If there is variable data to be supplied for 
the message, pointers to the variable inserts follow the message 
IB, and a one-byte count of these pointers will precede the message 
ID (see below) • 

I — I 1 1 1 1 1 

I C [ kkhK I AI AI [ P »P »P tP» ( pzpzpzpz I po , . . I 

I I I I I I I 

C = One-byte count of pointers (may be zero) . 

A = light -character message ID. This doubleword is 

addressed by word 2 of the parameter list. 
P»,P2^,..pii = Four-byte pointers to variable data, 
if any. 

Specified as s A relocatable expression or register notation (2 
through 12) . If register notation is used, the address must first 
be loaded into the specified register. 

flags 

specifies the address of a two— byte field where: byte 1 indicates 
the type of error that occurred, and byte 2 indicates additional 
information about the error. The flags and their meanings are: 

Byte 1 Meaning 

•10« EODAD or SYIAD condition 

•20» Clear last operation flag 

Byte 2 Meaning 

■0A« Called by one of the OPll modules CZCOA, CZCPl, CZCOP 

»0C» SDST error in CZCOA 

■01 ■ Hon-¥AM data set in CZCOZ 

Specified as : A relocatable expression or register notation (2 
through 12) . If register notation is used, the address must first 
be loaded into the specified register. 

Execution: fDMll closes the data set that is causing the error. If it 
was open, a temporary close (CLOSE, type T} is issued on all the data 
sets associated with that task. Diagnostic messages are written to the 

220 



user's SfSOPT ievice. If cxinversatlonal , control is rettiriied to tlie 
user's task. I£ nonconwersationalr the task is temiiiated. 

Example : I sjstes prograaaer, processing a fin data set, discovers am 
error condition, le issues TOIll in an attempt to recover from tliat 
condition without terminating the task associated with the data set he 
is processing. The three variable-data inserts to the message (that 
resides in SIS ELF) are antomaticallf included in the message when it is 
written to the SYSOUT device. 



12 


IQU 


2 


15 


Bftir 


5 


BCBIBG 


BQO 


3 


mmmmmmm 


FIlllETBl LIST FOl ¥I>I11 


CIT 


DC 


X»03» 


lllHSGID 


DC 


C"HSG0a232» 


¥111 


DC 


pnQt 


Til 2 


DC 


P«0» 


¥113 


DC 


F"0» 




DC 


1L1(L«¥I1BL1) 


¥A1BL1 


DC 


C»tiXT» 




DC 


IL1{L*¥I1BL2) 


¥A1BI.2 


DC 


C»TBXT» 




DC 


ILt(L»¥IlBL3) 


¥I1BI,3 


DC 


C»TEXT» 


###«### 


BID OF 


FIllHBTBB LIST ♦* 


¥D1B1PLG 


DC 


X»20» 




DC 


X»OB« 




LK 


6,¥A1BL1 




ST 


6, ¥111 




LI 


6,¥I1BL2 




ST 


6, ¥112 




LI 


6,¥I1BL3 




ST 


6, ¥113 



HDHBBl OF ¥I1IIBLBS FOl HBSSI61 

ID OF 11101 HBSSIGE II SISILF 

FOIlTEl TO ¥11IIBLE DITI TEXT 

POIWTBl TO ¥11IABL1 DITl TEXT 

FOIITBI TO ¥11IIBLB DITl TEXT 

TEXT FOl ¥I1IIBLB 1 

TEXT FOl ¥I1IIBLE 2 

TEXT FOl ¥I1IIBLE 3 

CLBIl LIST OFBllTIOI FLIG 
101l-¥ll DlTl SET II CZCOl 



SET DF FOIlTEl TO 1ST ¥I1IIBLE 
SET HF FOIlTEl TO 2lD ¥11IIBLE 
SET WF FOIlTEl TO 31D ¥11I1BLB 



LH 15>¥DIIE1FLG SET BllOl FLIG FOl lEG . lOTITIOI 

L 12,1111SGID SET WW HESSIGE ID FOl DIIGMOSTIC 

L DCB1E6,DCBID1 GET DCB ADDIESS 

¥DIE1 (DCBIBG) , (12) , (15) ITTEIFT EllOl 1EC0¥B1Y 



¥SBBD1 — Send Message to Task and Await lesponse 101 

The fSBlDl macro instruction is used to send a message to another 
task and wait for a response from the receiving task. 



Standard form: 



lame {Operation (Operand 
+ 



~f ^ ■ ^ 

(message textrreplf address, replf length, 
(message c^ode, sender 



[sjmbol](¥SBlDl 
I 
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L-f or» : 



1 

Opera-tion (Operand 



llaae 
I- 



f syabol 
I 



TSIUDR jaessage texi:y[ reply address ]^[ reply length], 
I [ Message code ],[ sender ],1IF~L 



lot e ; A syabol is required in the naae field. 

B-f or* s 



I i ' 1 

llaae (Operation (Operand 

I 1 1- 



t[syiibol](fSlHDl I, [reply address J, [reply length J ,[ message csode}, 
I I I [ sender ],lF=(lr list) 



Bote ; An operand oaitted in the L-£orB (except the aessage text) aost 
be specified in the l-for»; an operand specified in the B-for» overlays 
the saae operand that was specified in the l-fora. The message text 
■nst be specified in the I.-fors and oaitted in the E-form. 

message text 

specifies the text of the message to be sent. 

Speid-fied as : fext (a characrter string enclosed in apostrophes) . 

reply address 

specifies the location where the message reply is to be placed. 

Specified as ; In the standard and l-form, a relocatable expres- 
sion; in the standard and S-^form, register notation; also, in the 
£-form only, an 11 address. 

reply length 

specifies the length in bytes of the reply. 

Specified as ; In the standard and E-form, an absolute expression 
or register notation; in the L-form, only in register notation. 

message code 

specifies the message code. 

Specified as ; Same as for the reply length operand. 

sender 

specifies the ID of the task the issued VSEMBB. 

Specified as ; Same as for the reply address operand. 

Initialization ; I BCIISS macro instruction with the PlIfllEGEB option 
must be eroded in a module prior to coding ¥SB1BB. If more than one 
BCIASS macro instrncrtion is issned in a module, the last BCLASS issued 
prior to coding VSBHDB must be issued with the FEIVILBSED option. 

Execution ; ?SBID1 sets up control blocks described by DSBCTs CHAHBB and 
CHAHCB, sets up a message flag in CHIHCB indicating the 7SBHDB issuer, 
issues the fSBMB to the receiving task, and then issues an AWAIT macxo 
instruction. The receiving task sets up a reply in the message control 
block and issues TSBIBB. 
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XTBCT " Ei± ra ct Task Statms Inflex Fiell IRI 

The XTBCT macro instrmctioii peraits yon to extract aad exaaina one of 
a selected nuabei: o£ fields from four TSI. 

J ^ ^ ^ J 

(Haae | (deration (Operand I 

I 1 ^"H ^ ^ 1 

r [symbol] I XTRCT f [ tsi field] | 

I 1 J ^ ^ 1 

tsi field 

designates the TSI field yon want to extract and examine* 

Specified as : One of the codes described below ^ or, if a value 
corresponding to a desired code is first placed in register tS, as 

Meaning 

the user IB field 

symbolic device address for the input data set 
symbolic device address for the output data set 
operator/ (combined with privilege class— B) sys- 
tem programmer privilege 
system programmer, nonprivileged 
virtual system service routines 
user 

the conversational task flag 
the task ID field 
the intertask message flag 
the external priority flag 
the privilege field 

the auxiliary storage regnirement field 
the auxiliary storage count field 

Bef anlt : It is assumed the issuer has placed a code valne in 
register 15. 

Execution: The task status index field indicated by the code is 
extracted and returned to the program issuing the XTBCT. 

Bet urn Data : The extrairted field is returned right-aligned in registers 
and 1. The number of bytes returned is: 



corresponding 1 


(15). 




Code 


falue 


DSIBIB 


1 


SIS II 


3 


SYSOOT 


% 


SOPBIV 


6 


SPPBIV 


7 


SBPBIV 


3 


BPfilV 


9 


COMV 


10 


TISKIB 


11 


ITIFLG 


12 


XPB 


13 


lOTH 


14 


lAV 


16 


BISK 


17 



Seals ter 15 


TSI Field 


laplied Length (bvtes) 


1 


TSIOID 


8 


3 


TSISIH 


2 


4 


TSI SOT 


2 


6 


TSIOP (TSIP1) 


1 


7 


TSIPP {TSIF4) 


1 


8 


TSISP (TSIFft) 


1 


9 


TSIOP (TSIF4) 


1 


10 


TSIC7 (TSIP2) 


1 


11 


TSITID 


2 


12 


TSIHB (TSIF4) 


1 


13 


TSI XPB 


2 


ia 


TSIF4 


1 


16 


TSIAHF 


2 


17 


TSIllF 


2 



CIOTIOM: The smallest field extracted is one byte. If you are 
interested in a particular bit within a byte, you must mask out the 
remaining bits* 
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Exaaple ; Suppose fom wamt to fiai omt if jomr task is being run im tlie 
coii¥ersatioiial mode; fom aight writer 

EXllP IT1C3 COIV 



XTBCTL - Extract Control Beqisters (Rl 

Tke XflCTL macro instmctioa allows fom to extract a^A examine 
selected task control registers. 

I ^ — — ^ — T— — ^ — ^ -T" ^ ^ " ^ ^ ^ * ^ ^ ' — ^ 1 

flame Iteration 10 per and f 

I _.... ^ __^_».,^ ^ ^ _ _ __| 

|[ symbol] I XTRCTL |[ field- p!CHISK|PBlKASK |PE1GS|PEHIBB1 1 (15)} ] | 

field 

designates tbe control register function yon wisk to extracrfc and 
examine and may be written: 

ICllSK - extract monitor call mask CI 8 bits 16-31 
PlllISK - extracrt program ewent recording mask CI 9 bits 0-*3.. 
PllGl - extract Pll general register mask CI 9 bits 16-31. 
PBl&DBl - extract FEl address range CI 10-1 1* 

If jott ckoose to write register notation, yon mnst selecrt- tbe prop- 
er ¥aliie from the list below and place it in register 15 before 
issuing tke macro instruction. 



Coda 


falme 


MCMASK 


1 


PEIHISK 


2 


PBIGI 


3 


PESIDDl 


4 



Initialization : lone. XTICTL CIl BE ISSIEB FIOH PlIVILEGBD or lOlPlIt- 
IIBGED code. 

Execution: ThB contents of selected control register save areas in tbe 
XTSI are extracted and placed in register and 1. Tlie number of bytes 
and tbe specific control register fnntction to be extracted is determin- 
ed by tbe code contained in register 15. 

Code Implied Length fbytesi 

1 2 

2 1 

3 2 
H S 

Regardless of the length ,r the bytes are always to be right-Justified in 
registers and 1 . 

Example : Suppose yon wish to examine the monitor call mask in control 
register 8. Ion might write: 

EXIHHC XTBCTL ICMISK 



XTRSIS — Extract System Table Field fRI 

The XTRSf S macro instruction enables yon to extract and examine one 

of a selected set of system table fields, 
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I 1 1 ^ ' 1 

IHaae lOperation (Operand I 

I 1 1 ^ ^ 1 

|[syMbol]|XflSIS llsjstBm table field] I 

I I 1 ^ . 1 

sfstea table field 

designates the sfsten table field joa want to extzracrt and examine » 

Specified as ; One of the folloving erodes, or, if the value corre- 
sponding to the code is first loaded into register 15, as (15) • 

Code Valae Meaning 

TISKIlIf 3 the task initiation statns field 
IflUX 5 the available anxiliarj count field 

Default : It is assumed that the issner has placed a value in 
register 15. 

Execution ; The size of the field extracted is detemined hj the <:ode in 
register 15. Corresponding lengths are shown below. 

Code iMplied Length fbvtesi 

5 ^ 

Betnm Data ; The bjtes in the regnested field are retitrned right- 
aligned in registers and 1. 

Example ; Suppose fon want to learn the time of daj that the system was 
IFled. Ion might write; 

miE XTISYS TOD 

XTBXTS — Extract Extended Task Status Index Field fBI 

The ITBITS macro instruction enables yon to extract and examine one 
of a selecTted set of ITSI fields. 

J J ^: ^ . : J 

fVame (Operation (Operand { 

I 1 1. ^ . 1 

([symbol] (XTBXTS ([XTSI field] ( 

I 1 i.^ . . I 

XTSI field 

designates the XTSI field you want to extract and examine. 

Specified as ; One of the following codes, or, if the value corre- 
sponding to the code is fiest placed in register 15, as (15) • 

Code Value leaning 

the user time field 

the accumulated time field 

the estimated run time field 

the number of TWAITs field 

the number of ll&ITs field 

the number of time slices field 

the number of page-ins from auxiliary storage 

field 

the number of page-ins from external storage field 

the number of page-outs to auxiliary storage field 
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OTIIB 


1 


ATI HE 


2 


EST 11 


3 


TIAIT 


4 


lllIT 


5 


TSLICE 


6 


lUX-IM 


7 


EXT -II 


8 


A OX -OUT 


9 



BIT -OUT 


10 


HDISK 


11 


SET 2ft 


12 



the number of page-^outs to eztemal storage field 
the aaxlBUA pages used on auxiliary disk field 
24-bit addressing flag 

Default: If is assused that the issuer has placred a value in 
register 15. 

Execution : Registers and 1 are loaded with a doubleword extracted 
froB the issuing task's extended task status index (XTSl) • The number 
of bftes extracted depends on the field. The field lengths for each 
code that can be specified are: 



Code 


Implied 


Lenath f bytes) 


1 




8 


2 




8 


3 




8 


ft 




2 


5 




4 


6 




ft 


7 




ft 


8 




ft 


9 




4 


10 




4 


11 




2 



Return Data : The data returned will be right-aligned in register 1 with 
a left-fill (padding) of zeros. 

Example : Suppose you want to find out how much time your task has used 
since LOGOV; you might write: 

IAMB XTIXTS ITIMB 

ZEROSSf — Zero Statistical Recording Fields fOI 

The ZEROS ST macro instrucrtion sets the statistical entries in the 
system to zero, thereby reinitializing the table for recording of up-to- 
date statistics. 



I Name | Op eration | Operand 



I [symbol ]|ZBROSST | 

I I L. 



Bote : There are no operands. 

CAPTIOH : Use of SIC 19ft, generated by ZEROSST, is restricted to tasks 
having system programmer authority fO or P) . 

Execution : S?C 194, which ZBROSST produces, sets the statistical reco- 
rding fields in the resident supervisor to zero. These fields are: the 
system status table (CHJkSST) ; the schedule table counters; the page ste- 
aling counters; the scheduling counters; the drum to disk migration 
counters; the gueue processor time and use counters. 

In addition, the current time o£ day clock is recorded in SSTZET. This 
indicates to any data reduction or analysis program the zero time for 
the statistical recording fields. 
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Exaaple s I sfsten prograsner lias sampled sfstea statistics and process- 
ed that data to eTalmate the imteractive user-sfstea perforaa&ce* Ifter 
evaluating the data, he wants to reinitialize the statistical entries in 
■ain storage* 1 later sampling of statistics would show the system *s 
perfornancse from the tine ZlBOSSf is ezecrnted to the next tine S1HPI.1 is 
ezecnted : 



EI, 



0,1ECOED 



ZllOSST 



SXSCUTSS SIHFI.E IICBO IlSflUCTIOV 

DITE filBUCTlOl 

Z110S STITISflCIL 11C01BI16 FISLBS 
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I This section describes tlie coa»anis and special optioas available 
I oaly to system prograameirs. These conmaiids and options snpplesent those 
available to all TSS users, described in Co&mand System User's Guid e ■> 

In general, the commands described in this section enable system pro- 
grammers to update message lists, to better control data on auxiliary 
storage, and perform other types of system programmer functions. 

CQEIAMD CAID SPECIAL QPTIQMI DlSCRIFTIOgS 

The general explanation of commands, the rules for entering them 
position ally, and the types of messages issued by each are contained in 
Command System Pser*s Guide > GC28-2001- 

IDPPQQl Command 

This command adds a public storage pool to the system. 



Operation {Operands 



IDDPOOL lP00LID=pool identification 

|[,DB¥ICE = (2305|3330|333B|3350} ] 
|[ ,VOL!IKE=volume serial number] 
|[,IIAINT={ll|y} ] 



POOLIB 

specifies the pool identification of the public storage pool to be 
added to the system* 

Specified as ; from one to eight alphameric characters. 

BEflCE 

specifies the device type that the first volume in the pool is to 
be mounted on. 

Specified as : 2305, 3330, 333B, or 3350. 

¥OmiE 

specifies the volume serial number of the first volume in the pool. 

Specified as : from one to six alphameric characters. 

IJkllT 

specifies whether or not the pool is to be placed in maintenance 
status upon completion of the IBDPOOL function. 

Si^cified as : I or ¥ 

Befault : M 

Functional Bescription ; the IBBPOOL command reguires that all volumes, 
that make up the public storage pool, have been previously mounted and 
¥IRyed online. IBBPOOL will read the pool descriptor dataset SYSVOL, 
determine that all volumes are online and update the necessary tables to 
activate the pool. If llLltfT=y has been specified, the pool is placed in 
maintenance status to allow only the pre -joined user to LOGOl. k pool 
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tkat is in aaimteEaace status naf only be used bf tbe pre- Joined user. 
to all other ttsers^ including those who share datasets in the pool, the 
pool looks offline*^ fo remove a pool froE Maintenance status, the ADD-- 
POOL coaaand May be issued with just the FOOLIB and IIIMT operands* 1 

pool that is in maintenance status may be deleted • 

Frogrraaainq lotes ; this command is available only to SISOPIEO, 
MSKID==X»0001«. 



BLPFQQL Ccmaand 

fhis command provides four functions for pool management: 

1* build a new one volume pool from an empty private volume, 

2« prepare an eiipty private volume for addition to an existing pool, 

3- partition an existing pool into two pools, 

4. modify a pool's descriptor datasets 

r— — — 1 ^ — ^' ^ — • ^ — ^ ' ^ 1 

Opera ti on | Operands 

I" 



BLDPOOL |10I>E= pil IIDB r FllTllOB} 

I ,FOOI.ID==pool identification 

It ,CIT¥OL=p referred SYSCIT volume serial number] 
|[,llll1!l¥aL=p|l} ] 
I [ ,DE?ICE== {2305 1 3330 1 333B | 3350) ] 
|[ ,VOLIJiE~voluae serial number] 
|[ , OS EEID:=pre- Joined user identification] 
f [ ,E¥I=fi3cst relative volume number of partitioned pool] 
i — , 1 ^ . ,— ^ - - — ^ ^ ^ . I 

lOBB 

specifies the type of processing to be performed. IE! builds a new 
one volume pool, lOD will prepare a volume for addition to an ex- 
isting pool. Fill will partition a pool into two pools, and MOB 

will modify thm pool's descriptor dataset, STSTOl. 

Specified as ; IBW, 100, FAIT or 100. 

FOOLIB 

specifies the pool identification to be assigned to the new pool. 
This operand is required for 10DB=11W or FAIT. 

Specified as ; from one to eight alphameric characters. 

CI Tirol. 

specifies the volume serial number that will contain the STSCIT 
dataset- This operand may only be specified for 10BE=lOB. 

Specified as ; from one to six alphameric characters or one to six 
blanks to indicate that no volume is preferred for sysciT. 

miTIfOL 

specifies whether or not multi-volume datasets are to be allowed 
within this pool. This operand may only be specified for 10BE=!I0B* 

Specified as : 1 or I 

B^ault ; 1 

BB¥1C1 

specifies the clevice type that the new volume is to be mounted on. 
This operand is require for II0B1=1B1 or IBB. 
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Specified as : 2305^ 3330, 333B, or 3350. 

fOLOHE 

specifies the irolane serial nasber of th® new ▼oluae» This operand 
is requiredd for HODE=IISW or ADD* 

Specified as : froa one to six alpkaiieric characters* 

OSIHID 

identifies a pool^s pre-joined user. This operand is required for 
MODl=NEi or PIBf* 



IWll 



Specified as : from one to eight alphameric characters. 

specifies the relative volume number within the existing pool that 
is to become the first volume of the partitioned pool. This 
operand is required for MODI =P ART. 

Specified as : from one to three decimal digits. 

Functional description ; 
H0DB=IIE1 , 

The specified volume is mounted^ the label is read and checked for con- 
sistency ^ and the descriptor dataset^ SISVOL, is built. Empty datasets 
for SlfSOSE and SISSVCT are built and include the identity of the pre- 
joined user. A OSERCIT that contains entries for the constructed data- 
sets is built* Finally, the volume label is modified to include the 
pool and DSCB information required by an &DDPDOL command. 

10DE=ADD 

The specified volume is mounted, the laiiel is read and checked for con- 
sistency , and the pool's descriptor dataset, SYSVOl, is updated to in- 
clude the new volume. Finally, the volume label of the new volume is 
modified to include the pool information (e.g., POOIID) . The new volume 
will become available for storage assignment the next time this pool is 
■added ■ to the system. 

I«0BE=E0D 

The pool descriptor dataset, SISfOL, is updated to include the specified 
parameters. The new parameters will take effect the next time this pool 
is » added* to the system. 

«ODE=FAET 

The specified pool is checked for maintenance status; if it is not in 
maintenance the command is cancelled. Each user in the existing SYSSfCT 
is tested for EfH limit consistency and HOfEUSBl status; if any user is 
not in HO?EOSBB status, or is found to overlap the two pools, the com- 
mand is cancelled. The specified relative volume number is checked for 
consistency and the volume label of its volume is read and checked for 
consistency. The descriptor dataset SYSfOL of the new poolid is built 
from inf oniation in the SDIT, and STSVOL of the existing poolid is up- 
dated. Empty datasets for SYSFIIB, SYSBiQ, and SYSCAT are constructed. 
The datasets SYSUSE and SYSSVCT are built and include the pre- joined 
user. A USERCAT that contains entries for the constructed datasets is 
built. The existing SYSS¥CT is read to determine which OSBEIDs are to 
be included in the new poolid and both the existing and new SYSSVCT and 
SYSUSE datasets are updated accordingly. Finally ^ the volume labels of 
the volumes in the new poolid are modified to include the pool and DSCB 
information required by ADDPOOL- Before partitioning a pool, all 
userids in the pool must be •compressed"; i.e., a SETEfH and a lOVSUSBl 
with P00LID=*P00L must be issued for all userids. 

Proarammincr notes : this command with KODE=MEW is available only to TSS* 
****• For all other MDDEs the command is available only to the pool's 

230 



I pre- joined liser. the initial password for the pre-^joined user is 111. 

I Ihea 10DE=PAlTr aa ID0POOI. Must sabsegneatlf be issued against the orig- 

i inal poo lid to reaore it fro« maintenance status (thereby adding it to 

I the sfstes) . Siailarlj , an IBDPOOL aust be issued against the new poo- 

f lid to add it to the sfstea. 

I When M0I>E=AI>D, the new Toluae will not be available until first a 

I DELPOOL and then an ADDPOOL are issued against the poolid. 

I Examples : 

I BLBPOOL 10DE=ffElrF001ID=TSS002,I>EfICB=3350^ 

I ¥OI.OHS=?OL250 ,!ISBBID=Sf S002 

I BLBPOOl 10DE=1DD^I>EVICE=333B,FOL!I1E=?OL360 

f BLDPOOL 10DE=PIlT^POOLIB=fSSSIS05^0SBlID=TSS05p 

E?H=5 

I BID POOL 10DE=iOB^CITf OL=f OL 83 , iULf I ?OL=Y 



I BLDSfCf Coaaand 

I This coanand will reconstrucrt the siSSWCT dataset by searching a pub- 

I lie storage pool for OSBSCIT DSCBs. 



J J , 

I I Opera ti on | Operands 



I IBLDSVCT |POOLID=pool identification 

I I . . 



I POOLID 

I identifies the public storage pool on which SYSSfCT is to be 

I rebuilt. 

I Specified as : froa one to eight alphaaeric characters. 

I Functional description ; the voluaes that aake up the public storage 

I pool are searched for the "aost recent* CJSEBCtf datasets. SYSSVCf is 

I rebuilt froa thea by building a record for each USElCAf DSCB found. Ill 

i 1?M limit inforaation is lost. The voluae label of the first voluae in 

I the pool is updated to point to the new SYSSVCT. 

I Proaraaainq note ; this coamand is available only to TSS***** and aay 

I only be issued for pools in aaintenance status. 



CC (Check Catalog! Coaaand 

I This coaaand allows a privileged user to run an integrity check on 
the catalog and coapare inforaation in the data set descriptor for ?Ii! 
data sets to corresponding inforaation in the foraat B BSCB^ 

The catalog aay be inspected for one specific user, or if desired , for 
all users joined to the systea. 

Biagnostics are produced on SYSOUT describing the location and type of 
any irregularities o.nless the coaaand was issued conversationally and 
the *1LI, option was requested in which case any aessages are written 
into a data set and printed on a high-speed sprinter. Also, included in 
this coanand is the ability to display and/or patch the catalog of any 
user. 
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r 1 I 

lOperatloiil Operand I 
I 1 1 

|CC I IIS El 10= {user ideiitificatioa|*l.LLl ,[DISPLlI=relative page,] | 

I |[WRITl=relative page],[PSIVllE=¥olserEo] I 

I 1 I 

OSIHID 

specifies the user identification of the user whose catalog is to 
be exasined, displayed or written. 

♦ILL 

will check integrity of catalog for all users joined to the systea. 

DISPLAY 

specifies the number of tj^e relative page within the catalog which 
the user wishes to exanine and/or patch* Cannot be used with the 
*ALL option. 

illTE 

specifies the number or the relative page within the catalog which 
the user has patched and now wishes to be written out. Cannot be 
used with the »ALL option* 

PBIfJkfB 

specifies the volume serial number of the pack which the user 
wishes to have mounted to compare catalog and BSCB information for 
private data sets. Cannot be used with the *ALL option. 

groqramminci Mot e: The CC command will be honored only for users with 
authority ■0»* the CC command may be used in conversational and non- 
conversational tasks, fhe BISPLAT, llITE and PHIVATE options must be 
used on an individual basis. 

Check Catalog Processing * The authority of the user is first validated. 
fhe DISPLAY and IBITE parameters are checked and if both appear a diag- 
nostic is issued, lext a DCB is opened for TSS****«f.SYSCAT and a FIHD 
is issued against the userid supplied. If the *ALL option was speci- 
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tied, a check is maie to be sttre the DISPLAY, IIITE or PlIVITl parame- 
ters parameters vere not entered. If not, the user identifications are 
selected fron the FOB for STSCAT. The nserid is then passed to the FIID 
macro and processing continues the same as if the nserid vere passed in 
the command. 

If the nserid does not exist, FIID will retnrn an error code and a diag- 
nostic is issned. 

CHICK CATllDG processing is accomplished with two passes through the 
catalog. The first pass checks SBLOCK: strnctnre, and if no errors are 
found, a second pass is made which checks information in the catalog a- 
gainst information in the format E DSCB. 

SBIiOCK Checking . I GSTHAIl of three pages is done for buffers. The 
three buffers will now be denoted primarj , alternate and extra in this 
discussion. A call is made to the 6BT page subroutine for page for 
the primarj buffer. The number of pages in the user's catalog is sa^ed 
and eTerj relative page processed is checked against this number to de- 
termine if it falls within the range of pages allocated for this user's 
catalog. Then a SETL and GET are done to read in the relative page into 
the specified buffer. The fact that this relative page now resides in 
this buffer is noted. 

The first (next) sblock is checked for "bftes in use" being egual to 
zero. If "bytes in use" is egual to zero, the sblock is ignored. If a 
backward pointer exists and the address is on a §4 bjte boundary, the 
sblock is also skipped because in this case the sblock is either an ex- 
tended sblock or a sharing list and these are checked via a different 
route; i.e., through the index levels pointing to them. If a backward 
pointer is zero, a check is made to determine if its a backward pointer 
to relative page sblock 00. If it is, the sblock is ignored as above. 
The sblock identifier is now checked 03, 0*1, 05, and 06 and these are 
skipped since data set descriptors are all checked via a different 
mechanism. The sblock identifier c^n now only be an IIDfiX(OI) or 
GEIEIITIOI I1DBX(02). If not, a diagnostic is issued. 

The count of pointers within this index level is noted. If greater than 
three an extended sblock (s) will later be needed. The pointer fields 
are now examined individually by passing them to the FOIHTEl subroutine. 
The POIITBI subroutine checks that the pointer address is a valid point- 
er. If not, a diagnostic is issued. I check is made to see if this 
relative page is already present in the extra buffer; if not, a call is 
made to GETPJkGS with the extra buffer specified, low the backward 
pointer of the sblock pointed to is checked to see that it points to the 
proper pointer field. The qualifier of the original pointer field is 
checked against the gualifier in the sblock. The pointer names are 
matched to see if they are egual. Any discrepaniry is noted with a diag- 
nostic which indicates the locations of the problems found. Jill pointer 
fields are examined in this way. The absence of a pointer field indi- 
cates that the level has been exhausted, and this is checked with the 
count of pointers that were indicated. If there is a discrepancy, a 
diagnostic is issued. It this point, the next sequential sblock is pro- 
cessed. When all sblocks on the first catalog page have been pro<ressed, 
a GETF&GE is done on the next relative page of the catalog. When aU 
pages have been exhausted and no errors were encountered a switch is set 
which indicates sblock checking has been completer. If an error was 
found, SISCAT is closed and the next user's catalog is examined. If 
processing was for a specific userid, a return is made to the command 
system . 

Cataloq/DSCB Checking , If no errors were encountered on the first pass, 
check catalog now does a data check on the data set descriptors and com- 
pares catalog information to DSCB information. 
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flie first: (next) sblock is checked -to see if a backward pointer exists. 
If a backward pointer does exist, a check is made to see if it points to 
a sblock bonndarj. If so, the next sblock is obtained. If a backward 
pointer does exist, and the address is not on an sblock boundary, the 
identifier is now checked for a 06. When a 06 identifier is present, a 
check is Bade to see if the PlIflTl option was specified. If it was, 
the next sblock is obtained. When the identifier is an 06 and PBIWATB 
was not specified, a call is nade to a subroutine which will do a data 
check for valid flags on the 06 data set descriptor. Fields which are 
checked within the data set descriptors are: sharing flag; sharing 
privileges; data set retention and and access privileges; and data set 
organization. If any fields are determined invalid, a diagnostic is is- 
sued and processing continues. Next, a call is made to a subroutine 
which will build a fully qualified name. While building an FQM, this 
routine checks if the FQl bkcbb&,s 44 characters, and if so, a diagnostic 
is issued and processing continues. 

Ifter the FQl is built the FOlHIf E DSCB is obtained by issuing a SITX. 
Vext the FQM and the data organization information in the catalog is 
compared to corresponding information in the DSCB; any discrepancy is 
noted by a diagnostic, and the next sblock is obtained. 

When the identifier is a 03, a call is made to the data check subroutine 
and fields are checked for valid flags as above, lext a check is made 
to determine if this private data set resides on a disk; if not, the 
next sblock is obtained. However, if the private data set is of VEl 
format, a call is made to the subroutine which will build the FQH. If 
the PBITATE option was not specified, a message is issued stating on 
which pack this FQH resides. 

If the PlIflTE option was specified, the volume serial entered in the 
command parameters is compared to the volume serial number in the data 
set descriptor associated with this FQH. If they are equal, a call is 
made to Mount Request; otherwise, the next sblock is obtained. 

If the identifier is other that an 06 or 03, the sblock is ignored, and 
the next sblock is checked. 

When all sblocks on the first catalog page have been processed, a GET 
page is done on the next relative page of the catalog. When all pages 
have been exhausted, a FBEEllIW is done on the buffer pages. The DCB 
for TSS***** .SYSCJLT is closed and a completion message is given. Exit 
is to the irommand system, unless "t"!!]:. option was specified in which 
case, the above steps are repeated until all users* catalogs have been 
searched . 

When the DISFLII keyword is present, after parameter validation and a 
FIHD has been issued against the user»s catalog, the relative page is 
checked against the allowable relative pages for the user's catalog. If 
the page is legitimate a GET page is done into the display buffer, a 
message is now written out giving the virtual memory location of the 
display buffer. The userid for this operation is saved in the event the 
user wants to write this page with the WIITE option. The DSCB for TSS** 
♦**.S1SCAT is closed and a return is made to the command system- 

The user is now free to use PCS and/or VSS to review and/or modify the 
catalog page. The user may now use the write option of the command to 
write out any changes externally. 

When the hite keyword is present, after parameter processing is com- 
plete and a FIHD has been issued against the catalog, the input relative 
page number if checked for validity. Since the user is indicating that 
this is a page to be written out, this relative page must reside in the 
display buffer . h check must be made to insure that the relative page 
is for the proper catalog. For this purpose, the userid must match the 
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userid that was saved wheE the BISBLM keyword was entered • I pufx is 
now done from the display buffer for that relative page* The DCB for 
«USS*****,sysCM is closed and a FKEEMAIl is done on the display buffer. 
k completion message jjs given and a return made to the command system. 



Example ; 
User: 
System : 



User : 
System 



User : 
System : 
User ; 
System : 
User ; 
System ; 
User ; 
System 

User ; 

System 

User; 



User ; 
System ; 



CC TSS 

PHDCESSIMG COMPLETE 

SISTEl HIS CHECKED THE VILIBITY OF fSS»s catalog 

CC BOfD 

liCORRECT B&CKWIEB POIHTEl. lEL PAGE -- SBLOCK 

LOClflOM OF FOll&ED POIITES 00 0798. EEL PAGE - 

SBLOCK LOCITIOH OF BICKWAED POUTER 10FC0 

system has discovered an incorrect backward pointer in an 

SBLOCK with address relative page 1^ SBLOCK location FCO 

system has discovered an incorrect backward pointer in an 

SBLOCK with address relative page 1, SBLOCK location FCO 

the forward pointer resides at relative page 0^ location 798 

CC BOTD^DISPLAI^I 

user wishes to display page 1 

RELATIVE PAGE 0001 IS AT VIRTUAL MEMORY LOCITIOl 7F000 

DISPLAY L»7FFC0«.L«7FFFF» 
user displays SBLOCK in question 
(PCS or "953 displays SBLOCK) 

SET L«7FFC6»=X"98» 

user modifies pointer to point to correct place 

(PCS sets byte) 

CC B0YD^WRITE=1 

user wishes to write corrected page into catalog 

PROCISSIMG COMPLETE 

page has been written 

CC BOYD 

user wishes to check modification 

PROCESSISG COMPLETE 

catalog for userid BOYD is now correct 

CC *ALL 

user wants to check catalog of all users joined to the system 

System; B033 PRIHT ACCEPTED 

messages are printed on high-speed printer if *ALL option 

is entered conversationally 

CC found a total of 0000 errors; messages printed under 

DSMAME $$$000 15 

no errors were found in catalog 

CC TSS^PRIVATE=RELPAK 

user wishes to check DSCBs on private pack RELPAK 

PROCESSIHG COMPLETE 

catalog and corresponding DSCBs on RELPAK have been checked 



I CLASSGTF Command 

i This ccffltmand translates the captured trace data into formatted print- 

I able hexadecimal characters with labels. 
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I I Operation I Operand 



IGLISSGfF |Illl>Sl=^dsEa»el [ ^00TI>Sl=dsiiaae2] [ ,CLlSS=class[ , . .• ]] [r*B] 



IHDSl 

the name of the trace data set to be translated* 

Specified as : a 1 to 35 ckaracter name; the first character aust 
be alphabetic. 

Default ; none • 

OOTBSI 

the name of the ontpnt data set that will contain the translated 

trace data« 

Specified as ; a 1 to 35 character naae; the first character anst 
be alphabetic. 

Bef atilt ; if defaulted^ the translated data will go to the terminal 
only. 

CLISS 

Identifies the data classes to be translated. 

Specified as : iACHIIE 
Def anlt : none. 

specifies that translated data is to go to the terminal as well as 
dsnatte2. 

Specified as : B 

Default : translated data will not go to the terminal. 



CMfTPQQI. Q>amand 

This command is used to convert an existing fSS system Cp3^®'~P^blic 
storage pools) to a one pool system. The CMfTFOOL command is issued 
only once for each TSS system. 

1 " '" '■ "' • ' ' ' " ' " '• ' "■ ■" " ' • ^ 

I Opera tloni Operands 

1 ^ ^ _ ^ ^ . ^ 

IClfTPOOI. |POOLID=pool identification 

|[ ,CAT?OL=SXSCIT ¥olume serial number] 
|[,iULTi?OL=p|y} ] 

. , '„i 

POOLID 

specifies the pool identification to be assigned to the system 
pool. 

Specified as : from one to eight alphameric characters. 

ClTfOL 

S'pecifies the volume serial number of the volume to be used to con- 
tain the SISCAT dataset. 
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Specified as g froa one to six alphaaeric characters • 

lOLflVOL 

specifies whether or not multi-voluae datasets are to be allowed 
within this pool. 

Specified as : 1 or I 

Default s 1 

Functional description : ClVfPOOL is a one-tiae coamand used to build 
the necessary datasets and aodif j the volnae lablels of an existing TSS 
system for public storage poolSi* The pool descriptor dataset^ SYSfOl, 
is built f roa information in the public voluae table |CHBP?T) . f he SIS- 
?OLr SIS CAT, and SfSSfCT DSCB pointers are located and moved to the vol- 
iMie label of relatives volume zero* 111 volume labels are modified to 
contain the pool identification. 

Programming note : this command is available only to TSS*****. The 
userid TSS***** becomes the pool's pre-joined userid. 
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PDBf — Define a Data set 

hn explanation and the general forsat of the DDSF coanand is contain- 
ed in toaaand Systea User's Guide * fhe operand choices available to the 
TSS user vith privilege class S (systea nonitor) are described below and 
are in addition to the operand choices descrribed in Comaand Systea 
User's Guide * 

data set organization 

specifies a two -character code that indicates the organization of 
the data set. 

Specified as : HS - IS II faaltiple segaential access aethod) 

IIIIT= 

specifies the tfpe of device needed for the data set. 

Specified as : PI (printer) , PC (punch) , ID (card reader) , or a 
four-digit hezadeciaal nuaber (0001 to 7FFf) assigned at sfstea 
generation to the desired I/O device as its syabolic device 
address. (See in Part 1, •Reserving I/O Devices for a Honconversa- 
tional Task.") 

Mot e: the DISP keyword operand aust be OLD when using the card 
reader and MIW when using the card punch or the printer. 

DBIPOOL Coaaand 

fhis cx>aaand deletes an acrtive public storage pool froa the system. 

I 1 ■ ' I 

I Opera ti onf Operands I 

I 1 ^' ^ 1 

IDILPOOL |POOI.ID=pool identification I 

I |[^P0BC1-{I|H) ] I 

I |[^C1TFHISH={Y|H} ) I 

I I ^ ^ . I 

POOL ID 

identifies the public storage pool to be deleted froa the system. 

Specified as : froa one to eight alphaaeric characters. 

FOECl 

specifies whether or not active users of the pool are to be forced 
off the systea so that the pool aay be deleted. 

Specified as : I or I 

Default: I 

CAfFLOSH 

specifies whether or not t.he catalogs are to be flushed froa the 
SlSCkT dataset. 

Specified as : f or 1 

Default : I 

Functicmal description : DELPOOL will delete inforaatidn in systea con- 
trol blocks and logically reaove the public storage pool. If FOECE=I, 
all users logged on in the pool will be ^forced", all open shared data- 
sets in the pool will be closed and their users will ABltfD with comple- 
tion code 1; all JFCBs for all datasets in the pool will be released. 
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and tke p€)ol is deleted. If F01CE=1 the pool will not be deleted if any 
user is logged on to the pool or if there are open shared datasets in 
the pool; instead, a list of OSElIBs, along with their POOLID, that are 
logged on or that have open datasets is displayed, and the pool is 
Aarked in ■ delete status" to prevent new users fron logging on, and pre- 
vent additional shared datasets froB being opened. After all users have 
logged off and all shared datases have been closed, BBLPOOL mast be 
reissaed to delete the pool. 

Programiina note ; this comaand is available only to SISOPBRO, 
!riSKII>=X«O0O1«. 



DISP Cow Band 

This c:c»wand will display the contents of all or a specified part of 
the storage of an ICP/PIF or EP. 



I r 



i Opera ti on | Operands 



IDISP Iresonrce [,IHITLOC=) [,FIHLOC==] [,DSM11B=] [,1ICPDES=] 

^ I 



resonrce 

fhe nawe of the resource that is to be displayed. 

Specified as ; a 1-8 character nawe, the first character wast be 
alphabetic. This nawe wnst also be the nawe of a region in the 
TSS *****. SYSICS datasei:. 

IlltLOC 

the initial location of storage that is to be displayed. 

Specified as ; a 1-8 hexadeciwal nnwber. 

Default ; zero. 

FIllOC 

the final location of storage that is to be displayed. 

Specified as ; a 1-8 hexadeciwal nuwber. 

Default ; last storage location. 

DSBIHE 

the nawe of the output dataset that will contain the storage dnwp 
as specified above. 

Specified as ; a one to thirty-five character nawe. The first 
character wnst be alphabetic, lote; If this paraweter is owitted, 
the output will go only to the terwinal. 

ICPDES 

directs the output to the dataset only or to the dataset and the 
terainal. 

Specified as ; LD for output to the dataset only or LDT for output 
to both the dataset and the terwinal. 

lote; if the DSIJklB has been defaulted the display will be direct- 
ed to the terwinal only regardless of this paraweter. 

Default ; There is no default for this paraweter. 
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BxaEpie 1 : tiie user wants to display tue storage of the HP06 resource 
from location X»5000» to X • 10000 •, and he vants the data to go to both 
his terminal and the •DISPOOT* dataset: 

disp ep06pS000,,10000|rdispoiit ^Idt 

or 

disp resoiirce=eii06 ^iEitloc=5000 ,f inloc=10000 ,dsEaae=dispoiit,. 
iicpdes=ldt 

Bxaaple 2 ;: the aser wants to aisplay the storage ox the EP06 resource 
from location X»5000» to X*1000 0»,aBd he wants the data to go to his 
terainal only : 

disp ep06, 5000, 10000 

or 

disp resource=ep06yiBitloc=500 0pfiiiloc=10000 



DSCBS CoEiiand 

I This command searches a public storage pool for DSCBs (DSCB t?pes are 

I specified by the user) , makes an output list of DSCB data, and optional- 
I ly, catalogs uncataloged datasets . 



I fOperationl Operands 



DSCBS 



[LIST- {ALL lEBROR J^OTCAT f ALLEIP] ] 
[ ,CATAL0G={5lfY} ] 
[,CLEA»=ll!Hf} ] 

[ , VOLOME-^voluae serial number ] 
[ ^STARTDS=start data set naae ] 
[ ,REPORTDS=listing data set nane 1 
[ rUSBEID=user identification] 
[,CflKCAT={Nf¥} ] 



LIST 
I specifies the type(s) of DSCBs to be searched for (and listed) . 

Speci fie d a s : 

I ILL - specifies that all DSCBs (including the DSCBs for 

I noncataloged datasets and DSCBs that have errors) are to b« 

I searched and •listed*. 

I EIRDE - means that only DSCBs having errors are to be listed in 

I REPOBTDS; amoncf the errors checked are checksuii and DSORG. 

I NOTCIT - means the search and listing involves only those DSCBs 
i that are not cataloged. 

I ILLERH - means the search and listing involves only those DSCBs 
I that have some error, or are not cataloaed. 
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ChlkLOG 

specixies nhetner or not ancatalocied datasets ara to be cataloged 
I see CHSCIf )■ « 

Specif xed a s: Y or M 

Det aQl t: M 

specifies whetiier or not iatasets whick cannot be cataloged because 
of naEe or generation conflicts are to be erased. 

Specitied as : ¥ or M 

De£aalt : M 

specifies a single ¥olaifie serial iiiiaber within the pool that is to 
be usea for the search. 

Spe cifieu as: from one to six alphameric characters. 

Bei a lil t: the entire pool. 

SlkRThS 

specixies tiie dataset nana at which the search is to begin. This 
operaad is used to restart a previously aborted search* 

Specified as : from 10 to ft^ character dataset naae including the 
OSBKID. 

Def ault : the search starts at the first volmiie of the pool. 

f EFPOBTDS 

specifies the dataset iiane of the listing dataset. The dataset or- 
ganization depciRds upon the installation's sysgen value ^ or the 
user's default value: if the dataset is VI, entries will be made 
in alphabetic order; it the dataset is fS^ entries will be aade in 
the order found on the pool ¥oliiffie (s) « 

Specified as : a one to 3S character dataset name* If not speci- 
I fied, the user must DDE.F a dataset with a DDIIKE of DSCBSOUT before 

executing this C0iim.aad. 

USEE ID 

specifies the user identification of the DSCBs to be searched for. 

Specified as : froa one to eigiit alphaaeric characters; the first 
oust be alphabetic- 

Def anlt : all OSEBXDs. 

CHKCIT 

specifies whether or net the catalog is to be checked for uscata* 
loged datasets. 

Specified a s: T or !• If f ^ all uncataloged datasets will be so 
I aarked in the REPOITDS dataset. 

I Detanln : I 

Functional lescription : the DSCBS command reads all DSCBs on the public 
I volume fs) specified and writes a record into the EEPOHTDS far all BSCBs 

that match the input parameters. If the CATALOG option is specified, an 
attempt will be lade to catalog all uncataloged DSCBs that are found. 
I The BEPOPTDS vill reflect the current status of each DSC3 read. This com- 
aand can be used to print the status of all DSCBs on a pool. 
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FrogxaBMiaci note ; this coaEiand is available only to a pcx>l»s pre- joined 
mser, an alaiiiistra'*:or, or a manager. 

DOMgRlS CQ gaand 

This comaand will camse the storage of the resource to be recorded. 

r- T — ^ ^ ^ ^ ^ ^ ^ 1 

fOperati on f Operands I 

I ^ ^^^ ^ _» ..^ ^ 1 

IDtTKPEES I resource [^DSMAM2=] [,BMPPHl=] [ ,DEPPH2= ] [,DOKPDS=] | 

L. : J ^ ^ . . ^ . .— . -J 



resource 

identxfies the resource to be duaped. 

Speci±ied as : a 1-8 character naae^ the first character aust be 
alphal>etic- This aaae «ust also be the name of a region in the 

ISS *♦***. SYSKCS datase^. 

Def aclt ; There is no default for this parameter. 

DSHIHE 

the tiaae of the dataset that contains the load modules that will be 

used to transait the data froii the resource- These modules will be 
referxed to as the dump routines. 

Specified as : a one to thirtf-five character naae. The first 
chara.cter aust be alphabetic. This is the naiie of the dataset that 

con tad ns dmpphi and diipph2. 

DEPPH1 

the rame of the load module which is the first phase of the NCP 
dump routine. 

Specified as ; a one to eight character name. The first character 
must be alphabetic. 

Def attlt: user specified in the TSS*****.SYSBCS dataset. 

DMHPHI 

the name of the load module which is the second phase of the MCP 
dump routine. 

Specjjfied as : a one to eight character name. The first character 
must be alphabetic. 

Ber ault; user specified in the TSS*****.SISECS dataset. 

DUIIPDS 

the name of the dataset that will contain the record of the 

resource storage. 

Spe c ified as : a one to thirtf--five character name, the first 
character must be alphabetic. This is the name of the dataset that 
will contain the dump output. 
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EVV CEater ?IE foluael Conmand 

This coamaad catalogs private ¥IM woluaes by ¥oliiae^ 

I Operati oaf Operand | 

|E¥? iDSfiCE=de¥ice ty pe,.fOLUEE^ (voluae serial aiiiiber[ ,, •- . ]| | 

I f [ ,nSBEID=iiser ideBtification ] I 

DEfICE= 

specifies the type of direct access de¥ice tiiat the ¥&H Yolume is 

Specjjixed as : 2311,. 2314, 3330^ 333B , or 3350. 

¥OLUEE= 

ideiitifies the volume or volumes to be processed. 

Specitied as ; One to six-alphaMeric characters composiEg ttie vol- 
Giae i^rial Eiifiber for eacli voiuae; tue voliiii.e serial numbers are 
enclosed ia one set of parentheses. 

specifies user ideatificationi, which is ased to aaiEtain compatibi- 
lity between systems; this operand is available oBly no the system 
adainistrator or the system manager* 

Specilied as : One to eight charactersir the lirst of MHich is 
alphabetic. (If less than 8 characters » the system wilx pad to the 
right with asterisks*) 

P et ault ; The issuer's user iientif icatioa . 

Fmictional Description : E?? catalogs all aata sets oa the woliimes 
specified. 

Progragjiiaqr lotes : Ef? allows the user to introduce flK data sets 
created uEder other TSS sys tarns to his curreat installation |, or to reca- 
talog previously deleted Wh'A data sets^ Private flH data sets created 
Ender TSS are ao,to«atxcally cataloged* 

Example : Oser lilBI has three private wolaat^s which arci necessary for 
the execution of his program; he wants to enter them into the system « 
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Oser: ev^i 231 1^ (11 ISOO, 1 11S0 1 ^1 IISO^) ^aaybl 

System: Cf^<^kes catalog entxries j:o£ all data sets residing on the 
specified Yoiuraes.) 



FIXCIY ConaaB d 

i This command vill correct or relniilci a cataloo by checkina the iiEer»5 .--it 

t log datasets against public storige -i ncl critaloqina ari\ ancataloqed d=itd f-v-i. -. * 

I optionally, will coipletely rebuild the catalog datase«ts from dscb infornati 



Operation I Operands 

fIXCht f OSBHIB-user ideBtitica tioii 

|[ ,SYSCAT2= {N| Y} ] [ , 3YSC:.'V ^- (J I I] '] [ , MOFI X= {N | Y} } 



^ U ^ v\ < 



OSSEID 
I identifies th,e user whose catalog datasets are to be fixed. 

S pecified a s: from one to eignt alDhameric characters; the fici-ri 
alphabetic. 

i D efaul t: none. 

SYSCIT2 

specifies whether or not the SYSCITz dataset is to be erased and 

by the SISCA:? dataset. If this option is specified, the new SYSCMJ datr— 

set will then be checked for errors - 

S pecified a s: f or N 

D efault : M 

SYSCAT 

specifies whether or not the 5YSCAT dataset is to be erased and rt-ol^r,-^ 
by the SYSCIT2 dataset. If this option is specified, the SYSCAT2 dat.^, set 
will be checked for errors. 

Specified a s: Y or N 

Default ; M 

fote: If both SYSCAT2=^Y and SYSCAT-^Y both datasets will be erased and rrb-.-ll 
by cataloging all of this user's datd^-ets found on public storage. Mo+-e that 
this will result :.n the loss of all :-haring information and also the losi; oi 
all entries of prrLvate data sets - 

NOPIX 

specifies whether or not anv chanaef ar^"^ to be made to the cataloa -iTita- 
sets- If NO]^IX=Y is specified md an error is found in the cataloa^ a 
diagnostic w:.ll be issued stating that an error was found, but no ch^na^-s 
will be made to the cataloa datasc^t.s. 

S pecified a s: Y or N 

D efault ; I 

Functional descr ipt ion : The SYSCAT dataset is the backup copy of the catalog 
and the SYSCIiT2 dataset is the working copy of the catalog. The FIXCAT command 
will cause the SYSCAT2 dataset to be verified first. All pointers within the 
SYSCIT2 dataset w:.ll be checked and if an error is found, the bad entrv will be 
deleted* When the internal checkina is completed, public storage will be 
searched and any additional datasets will be cataloqed. 
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i If the SYSCAT2 dataset cannot be used , the SfSCIT dataset will replace the 
I SYSCAT2 dataset and cataloa verification will continue as stated above, 

Onlj if both the SYSCAT and SYSCAT2 datasets cannot be used, will the cata- 
log be coipletely rebuilt by scan^iina public storage. 

Pro qraaainq note : This command is available only to the oool owner. 

F IXDSCB Command 

This coiiimand allows a privileged user to analyze and optionally 
rebuild a DSCB chain. 



Operation | Operands 
f- ^ 



FIXDSCB |DS!lA?!E=dataset name [ ,uSFRID=user identification] | 

P[ ,PATSCA^=CY|H} ] [ pFix={IfM} ] \ 

-_ 1 1 



DSNAHF= 

identifies the dataset name of the DSCB chain to analyse. 

Specif i ed a s: a fully qualified dataset naie 

Defaul t : none. 

OSERID= 

specifies the dataset owner identification. 

Specified a s; three to eight characters r the first of which is 
alphabetic. (If less than eight characters, the system will pad to 

the riaht with asterisks.) 

Default: the command issuer's userid. 

?ATSCA1= 

specifies whether or not to scan the PAT for DSCB pages and add 
bacX into the DSCB chain any format "G" slots which are not in the 

chain. 

Specif i ed as: Y - scan PATs for lost slots 
?l - no PAT scan 

Defaul t; N 

FI2= 

specifies whether or not to correct any slot errors enco^untered 

while scanning the D?CB chain. 

Specified a s; Y - correct errors 

M - no error correction 

Defaul t: M 

F unctional Description ; FIXDSCB will obtain the format "E" DSCB pointer 
by calling LOCFQN. After readina the format ••E" it compares the name in 
the DSCB to that in the returned catalog sblock. If the names do not 
match an error message is issued and processing is terminated. 

FIXDSCB can only be used with type 2 format "E" DSCBs connected to 
fORMAT »»G" DSCBS. If the format "S" is not the correct type processing 

is terminated. 
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All DSCBs in ti^e chain are real in and error checked, and an aporopriatc^ 
error messaae is issued for anv errorF encountf^red. A table (CFATBL) is 
built in virtual memory describina the D5C3 chain. This table contains 
such things as the DSCB seauence counter , address and error indicators 
and is used in conjunction with the PATSCA.^ and FIX ootions of the 
coi!i.pand ► 

If the PAT5CAII option was selected^ FIXDSCB, uoon completion of the 
error analvsis phase^ will scan the PATs for lost DSCBS. Any format "G" 
DSCBS whose format "IV* pointer matches that of the format "E" DSCB, and 
are not in the DSCB table (CHATBL) will be added to the end of the 
table. After the PATs are scanned lost DSCBs will be added to the end 
of the DSCB chain based upon the sequence counter in the DSCB slotr 
lowest slots added in first. 

After error analysis and PATSCA.t, FIXDSC3 will correct slot errors and 
update DSCE oage counts if the FIX option was selected. Slots with 
invalid format "E" oointers are removed from the chain, external paae 
entry counts are corrected^ seauence counters are corirected, and 
CHECKSUMS are computed. Finally the format "E'» is rewritten with the 
correct pace counts. 

FIX VI CoMma ad 

Tuis comaaEd allows a privileged user to rebuild tiie directory for a 
broken VISA a data set or fISAM aeaber of a partitioned data set. 



J — ,^ — ^ — ^ ^ — ^ _ — . — _ — -__ — _„. — — «^__ ^ ^ — _ — . — _ — ^ ___^ — _ — ^ — ._,._„^ 

Opera ULOBf Operand I 

_ 1_™ _ ^ .„_ „ ^ — _™„._ . ^^^ ^_.._^™^_„„._^ 

IlXfl I DSNAaE^ddta set naiie[ (ineiiiber name) ] i 

|[ ,OSEfiID=user identification] [ ,FATSCA!1 = I| ]!I ] | 



hS3AdE = 

identities the data set ,r residing on direct access storage, that is 
to be rebaxlt. Tiie data set ^ust be in flSIM II format* 

Specified as ; a fully qualiiried data set name and (optionally) a 
aeaiber naae of a ¥PAM data set. When specified, the aenber came is 
enclo.^ed in parentheses and iamediately follows the ¥PIH data set 
name. 

osi:hid= 

specii.ies the user's iaentitication 0£ the data set owner. 

Specified as : one to eight characters ^ the first of which is 
alpiAaiietic. |It less tnan B characters^ the system will pad to the 
right iiith asterisKs«| 

Defaul t; the user^s identification. 

PATSCAS 

speciries whether or not to scan the PIT ^ages for X»4 1* pages and 
add Lack into the dataset any pages whose fomat •£■ OSCB pointer 
matches the format 'F" pointer for the dataset « 

Specjjiied as ; 1 - scan PkTs tor additio&al pages. 
i« - ao PAT scan- 

Deiaiil t: B 

Fuactional JUescription ; FII¥I will reconstruct the directory ior a 
WlShn data set or a ¥1SAM meuber of a partitioned data set* FIXfl 
should be used, when a fISIH data set becooes uiiiiseable* This is usually 
XQdicated by error Messages out of the WISAE access aethod routines. 
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Mhen invoked, FIXfl will first delete the existing directory. Hext, 
it trill save tne couat oi data pages in tke data set and set tke EBSTBL/ 
rnenber header page couiei: to zero. Pages are thea input (¥ia SETXP) and 
added bacJc into the data set one at a tine. Is each page is iupmt, it 
Will be validity checked before being added nack into the data set. Tae 
fomat •£« pointer on the page is coiapared to the fomat •£• pointer of 
the data set tor ?I data sets, and tiie nnigne aeaber pointers on the 
page are cx>apared to each other for fT members of partitioned data sets. 
Pages with bad format •£* or aeaber pointers will be deleted. 

flXVI uses SETL and ABE (adi directory entry) to perform data set 
positioning and directory rebuilding. Is each data page is input, FIX¥I 

will locate the record with the lowest key and use this as input to the 
fISIH SETL routine. If the key is not a duplicate, the page is added to 
the data set and IDE is called to update the directory. 

Ihe FAfSCIi option, when selected, will be perfomeii after existing 
data pages have been processed. Only pages whose format •£• pointers 
natch that of the dataset are called back. 

Ettpty pages, pages with invalid format •£• pointers or meiLber point- 
ers, and pages with duplicate keys will be deleted fron the data set. 
AG, appropriate aessage will also oe sent to SYSOUT stating the reason 
for the deletion and the BPM of the page deleted, ifter all pages have 
been processed and the directory rebuilt, the user is prompted as to 
whether or not to output the new directory . 



2110.2 



I GfF CG^ieral Trace Facilitvl Cottaand 

The GTf cxiAsand will cause the data specified (interrupts^ events ^ 
etc.) to be recorded in the Banner specified. 



I 1 ' 

O perati on | Operand 



GTW I {i;i0={l|lj ][,XPI={T|1) J[ ,SDA=sda[-sda)][ ,.lID=rid[-rid]] 

I [ ,S?C=eirc[-svclI ^FI=pi[-pi]l , EXf =ext ]-ext ] 1 ,HC=mct-Bc]} 

I 

nflkSK=([TiSKID=taskid] [ ,S¥C=svc[ -svc]] [ #5I=pi[ -pi ]] 

I [,lXT=€ixt[-ext]] [^MIM={f|inn 

I 

r ^£DSiAlB=dsnatte|I01EPlDT=IJ [ ^1EP01T=Y] [ ^TEICII>=niimber] 

I I . 

Mote: all operands are kefword. 

10 

specifies whether or not I/O recsording is to be done. 

Specified as ; 1 or H 

Default: I 



XFI 



SBh 



SID 



S¥C 



specifies whether or Inot external program interrupts are to be in- 
cluded in the trace. 

Specified as ; I or 1 

Defaul t; I 

the symbolic device address or a range of symbolic device addresses 
froB which data is to be recorded. 

Specified as ; a decimal integer Cs) or as a hexadecimal integer (s) . 
k hexadecimal integer is preceded by the letter X and the integer 
is enclosed in single quotes; for example^ SDA=X»10«-20 means that 
recording is to be done on the range of devices with symbolic ad- 
dresses of de<:imal 16 (X^10») through decimal 20. 

Default ; none. 

identifies the resource (si to be traced. 

Specified as ; a 1 to 17 character name, the first character of 
which must be alpahbetic. This is the name of the resource or 
resource range that is to be traced. If two resource names are 
entered^ separated by a hyphen r all the resources having network 
addresses in between the two named (and including the two named) 
resources will be traced ^ provided the two are in the same SUBABHI^. 

Default ; none - 

identifies thcj SfC number (or range of SfC numbers) to be traced. 

Specified as ; a decimal integer (s) or as a hexadecimal integer (s) . 
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I Default : none* 

PI 

icLentifies the prograa interrupt (s) tkat are to be traced. 

Specified as ; a decimal integer (s) or as a hexadeciaal integer fs)^ 
Default : none. 

lit* 

identifies Itlie external imterrnpts that are to be traced* 

Specified as : a decimal integer fs) or as a hexadeciaal integer (s) . 
Default ; none. 

specifies that monitor call recording is to be included in the 
trace. 

Specified as : a decimal integer (s) or as a he3»deciBal integer (s) . 
The naximnm number of calls that can be traced at any one time is 
decimal ten. 

Default : none. 

ITIl 

specifies that If II tracing is to be done. 

Specified as : 

*E1T - all ITIl entry points that are called wMl be included in 
the trace. 

*FIO - all ICP SIA headers fex: TH ♦ IH...) are included in the 
trace. 

Default : none. 

TASK 

specifies that tracing is to be done at the task level; if this 
operand is specified, all operands that precede it in the metalan- 
guage format shown above cannot be specified. 

1!1SKID 

identifies the task for which tracing is to be done. 

Specified as : a two digit hexadecimal number. 

Default ; none. 

lote: SWC, Bl, and EIT at the task level have the same definitions 
aM specifications as those given earlier for the 10 level. 

BTIH 

specifies, at the task level, that all interrupts that the task re- 
ceives from TkETl are to be recorded- 

Specified as : T or M 

Default ; 1 

DSHIIE 

specifies the name of the data set that will contain the trace 
data. 
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Specified as : a 1 to 34 alpnamiaeric naiie; the first character 
must be alphabetic* 

Def aiilt s see lOllPOlT below. 

lOlBPOlT 

specifies that all trace data will aot be accumulated; instead a 
circular log will contain the trace data. 

Stiecified as ; ¥ 

Default ; all trace data will be accumulated in the iata set speci- 
fied by DSMAMl above. 

EBPOIT 

when issued, whatever is in the circular log will be sent to the 
terminal; this operand has no meaning if DSMAIE is specified. 

Default ; none. 

!raiCID 

a system supplied identity that permits the programmer to communic- 
ate with the system regarding a trac^ that the programmer had pre- 
vio usly initia ted . 

Specified as ; a decimal integer {sent from the system to the pro- 
grammer after the trace has been started) . 



EMD 



Default ; none. 

specifies to the system that a trace is to be ended. 

Specified as ; Y 

Default ; none. 

Examples 1 ; to trace all I/O interrupts and I/O instructions issued to 
a bank of tape drives whose SDIs are X«40* through X»«I6», enter; 

gtf sda=x»'»0-i:*46»rio=y,dsttaae=tapegtf 

This GTF .commanci will cause the following display; 

GTF TBICB HAS STIITID IID TKICB OD IS - number 

The number displayed is Ithe TEACEID number to be used when the trace 
is to be ended, as follows; 

gtf end=y , tracid=nuffiber 

The above command informs the supervisor that the GTF reguest identi- 
fied Iby ■number ■ is to be stopped. The supervisor will stop the trace 
and send back to the issuing task the last filled or partially filled 
record written to the trace data set. After the record is written, GTF 
closes the output data set and prompts the user that the specified GTF 
reguest has ended ^ 

Examples 2 ; this example illustrates how to maintain a short log of 
previous events using the iOBlPOET and BEFOET operands. Assume a group 
of 2250s on a single control unit which hangs under certain conditions, 
and the maintenances person wants a log of the I/O events preceding the 

hang. A 32000 page data set of trace records is neither needed nor 
wanted — the hang may not occur for several hours or even days. To ob- 
tain such a log, issue the GTF command with the SOBEFOHT operand and an 
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SDA range vklcli included all 22S0 SOIs on the particular control unit. 
Issuaing tlie SQks were X»30» throngk X«33«, enter: 

gtf io=j^sda=x»30»~x«33«,noreport=f 

This vonld cause the supervisor to allocate a 2048 byte block for 
maintaining a circular log of all I/O events concerning the given SBHs. 
The size of the entries in the log are 48 bytes in length vhich aeans 
that the log would have a Baxiaun history of 42 entries* 

When the 2250 control unit hangs, enter the folloving coaaand to 
cause the log to be displayed on the terainal and a fresh log block to 
be started: 

gtf report =y,tracid=nuaber 

Mote that nuaber is the trace nuaber displayed as a result of a pre- 
viously issued GTF coaaand. This causes a display of the circular trace 
log but does not stop or end the trace. To discontinue the trace, 
enter: 

gtf end=y,tracid=nuaber 

This last coaaand will stop the trace and vill also cause the con- 
tents of the last trace block to be displayed at the terainal. 



HAPGEM " Create Task Storage Map 

The MIFGIM coaaand creates a dataset consisting of a coaplete storage 
aap for your task. You aay obtain VM, BC or both, with or without entry 
points . 

I 1 1 

I Opera ti on | Op erand f 

I 1 : 1 

IHAPGEi |[TIPE=][ ,LEVEL=][ ,PEI»T=][ ,EP=][ ,1UHH0DE=] I 

I I I 

TYPE 

identifies the type of aaps desired. 

Specified as : EC, ?M or ALL 

Default ; ALL 

LEVEL 

Bay be specified as a character string which will be the title of 
the aap dataset developed. 

Spe cif ied as ; a character string 

Defaul t: ???????????????????? 

Executio n: 

PRIMT 

specifies whether or not the dataset is printed 

Specified as : Y or M. 

Def anlt : Y. 
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Specifies whetker or not: entry poiats are to be iEcluded in the 
dataset. 



Specified a s : 1 or 1 • 

Def ault; «• 

EllHOBE 

specifies wketner or not a non-coniersatiofial task is to be created 
to Duild the aap dataset «. 

Spe cif ied ds ; FOSE or BACK* 

Default: FOBl- 

Fnactional Description : Ki?GFt reads tne TL'i for its task and tailds a 
dataset froii tke entries. It sorts the Banes alphabetically and lists 
fH and EC names separately xn the dataset. 



RQ¥gOSE£ Coaeiand 

Tikis cciimaiid Eoves tte data owned by a user and the associated SIS- 
DSt^ SISSICTt and USKRCAT records to a new pool. Also^ it Mill move tue 
user datasets on a |iOol onto a previously specified subset of F¥l num- 
bers within the same pool (the *coi&,press* option) . 

Mote : all users on a pool aust be •coapressed* prior to aay Dartitioa- 
ing of tilt- pool (see the bLDPOOL conffiand) • 

r- — — -~ — r™ — ^ — -— — — — -.--_ .-. ^ ^ ^ ^ — .-_„-.™_ — ...--^-^ 

fODeratioL fOperands I 

l„„J__^..^+...._^ __»___..__..___._^._^^ ___ ^ _^ 

lEDfEUSEE I ilSERID=iiser to be iO¥ed/coapressed 

I |[ ,POOLID=' {naae of destination pool|*POOL}] 

I } [ ^COIIF=coiifiriiatioii messages] 

I |[ yERASEOLD^erase dataseton old pool after iiO¥e ] 

I I [ ^PAGSCHE=clieck rvns of all data set pages] 

I f [ ^!roiJID = lastinatioB userid] 

f f[ /QUITUIC=aiiit user oPx old oool after move] 

I I [ yDUPAClOM^actioD if touid catalog already kas data set] 

!______-__.«--_ ___ -A_™_-_»_™- . _«„__^ .___. -_ , ™ . ™ ™_ . . . -.™_J 

Note: iiOiEUSliB has been writtea so ttiat the coaplete status ot tiie move 
is cataloc:;ji before and after unv axternal data operation is taken. 
MOfEUSSF: has complete recovt^raDility ; it can be restarted from any 
poioti^ after the initial checking and locking roatines have co&^ieted 
iEitiaH 2c tioE« 111 dataset stat as iaforaation is kept in the catalog* 

USERID 

ident^-ifies the user whose data sets are to be moved; this parameter 
must be specified. 

S.:pe cJx ied as : one to eight alphameric characters; the first Bust 
be aJ,.p*iabetic. 

POOLIB 

ideEi.ifies the i>ool to which the user's datasets are to be aoved; 
this parameter autt be specified. 

Spe cj .fied as ; one to eight alphameric cnaracters, or ♦POOL. If 
*POOI. is specified, a SHTHT^ aost have been previously issued for 
the user, and the aser^s aatasets will be 'compressed* withiE the 
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K #;« liiait;^ or this SETRfM coffinand, within the sane pool. (Refer to 
Sole,; 0*1 ier the S3TRf?:' coMiap.d description.) 

COIF 

j.iiJicd"L:3 #itT>t.h€!r or i.ot coaf imation nessages are to be issued as 
J a t. ^ s H t ♦"> d :: 4 - J3 o i^ e<i . 

'l£!^i:ii,hMiL..Fil»* f or 3 
:> .if ail It: 7 



ii).l i c.i t-r:;, wbetlier or cot data sets are to bPi erased froa their o- 
ri'jiirii. location after- being aoved* 

D_et a uit: I 

iolk^ ''■■■ 1H.)0I,ID=*P00I.|, EMSE01.D=f is in force; if TO0ID=USEEID and 
POOLii) not e^oal to *POOL^ fiEISlOLB caBEOt be specified. 

rfiiJI I.I 

iiie atiiies the userid in tke new pool who will own tiie datasets be- 
ing iioFed^ 

Specified ^ .a^: one to eight alphaaeric characters; the first lust 
Lk' alphabetic. 

D c^l a.gl t : USEEID; i.e.^ the user will have the saae identity in the 
n./^w pool that he/she Had in the old pool* 

i.9i^- TOUID can be pre- joined or not^ bat cannot be joined to any 
r;.x>l except the one specified in POOLIB* 

no'^iziq to a. new pool loses all sharing infomatioDi, , bat builds a 
oiw , coapressed catalog* 

If POOLID=*POOL the TOUID parameter is igaored . 

PIGECfiK 

iDdxcates whether or aot all dataset pages frather than the DSCBs) 
are checked to determine if any lie outside the 8?S liiiits in force 
lor tills OSEBID^ This parameter is aeaningful only if 

Specilied ^,^as: Y or S 

Default: f if M!JLTIfOL=I; i if M0LTI¥OL=^J« . 

CAUIIOt^ : if MOLtlfOL was I and is now n, PAGEChS=I must be specified; 
otherwise, any dat..i pages outside the fifl limits now in forcw for this 
OSSEIB will be lost. 

indicates whether or not the OSEfilD (in the old pool| is to be QUIT 
df.tfr tritt ddtast^ts have been mo¥eci to the new pool. 

:->p«citi a d as : 1 or i 

b ef A uit : 1 

-'211-: "-£ POOLID-=*POOL^ the QUITUID Darameter is ignored. If 
foiJIl}=USE-piD, M cannot be specified. If QUITaiD = H (and is valid), 
ail tiie user datasets will be duplicated under the new userid. 



identifies the action xo be {>erforaed it a dataset aaiae to Be iao¥ed 
already exists xn the TOUID's catalog. 

Specified as : 

SEiP ~ do not copy the •froiii» dataset. 

COPY - the TOUlD's daraset is erasea, then tna DS3I<ID dataset it: 
copied. 

liSCBCHK - a check is made to see if the datasets are sintilar; i£ 
not^ thea COPY is assumed. ihen they are similar the 
change dates are checked: it tue 'froa* dataset is 
iieiier, COPY is assumed; if tae TOUIB's iataset is naver, 
SKIP is assumed. 

Betault : S^IP 

Functional description : the prograa makes checics on the pri¥ilege of 
the issuer, then checks the input paraiieters for ¥alidity. fhen the 
following checks/locks are Eet: 

A. OS Eft IB has no currently active tasks, and tuere is enough space on 
the destinatioD pool to hold all the 3EBID datasets. Tuis check is 
done on a dataset basis tor a compress move; i.e., nhen 
POOLli>=*POOL. 

B. the OSEfiII>/l!OOID is placed in eOflllSEB status. 

C. the 0SERIJ>/TOlilD datasets are locked, and are not accessible to any 
user except the one executing the move. 

D. a unique generation data group is cataloged. 

B. the OSEBID/TOO'ID SfSSfCl' records are updated to reflect KO¥r*CJS£R. 
status. 

F. those datasets to be moved {those outside the H¥l liikits) are marked 
in tue dSfifilli's catalog. 

The initial phase of MOfEUSKE is now complete and MOfEOSER enters the 
•movedata' phase tfhere the aariied datasets are noved. In case the job 
abends for any reason, it can be restarted by re-issuing the com.© ana. 

The foUoMing is the sequence of events in moving one dataset: 

km a space check is made to see if there is enough space within tjie 

destination pool. If there is not enoug space, an inforitation aes~ 
sage is issued and the next dataset will be iioved. After all data- 
sets are moved a check is nade to determine if any were skipped: if 
all were aoved, the program goes to the next phas^e; if any Mere 
skipped, there will again be a space caeck and it there is still not 
enough space for any dataset, HOfSOSEB will exit with an error aes- 
sage leaving the OSEfilD in a aOVi::ilSEB status. 

B. !I*he 0SIRIB/TOOID datasets will be BDKFed and ¥f |f AR-TO-*?AR| is 
called to copy the dataset. If there is an abnormal teraination 
during the ¥¥, when aoviOSSB xs restarted, the partially copied 
dataset is erased and tiie ff is attempted again. If there is a 
second abnoraal temination, the dataset will then be recataioged 
under the userid performing the aove. 

I C. For TOO ID =11 S El IB, the following six steps are performed: 
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1. I'he aew £ DSCB is updated with the original nsiAillS. 

2. :i*iie original sblock DSCB Dointer is changed to point to the new 

aataset « 

3. The old DSCa is updated to the iiniqme DSIAMB. The catalog 
^.t»iocJt B5CB pointer is changed to the new dataset* 

4. xLe old aataset is erased « 

5. The catalog is updated to reflect the ao^e is complete. 

6. Confiraation messages are outpiitted |if COIiI'=Y) . 

Alter all aatasets are Eioved, the •movedata^ phase is completed by 
apiating the catalog to reflect MGfEUSBl is now in the JOIII phase. 

The jOTS phase performs those itess necessary so that the user will be 
able to logon the new pool after the ao¥e is coapleme . The OSEECAT is 
isoved to Che new pool, the SYSOSE, STESVCT, and CUBOID for the new pool 
are updated. After the JOIl phase xs completer this information is kept 

in the SISSfCT entry of the iiSEHI0/lOUID. 

I when OUITUID = Y^ the USERID is rrnit from the old pool. This consists of 
"Jeleting tne SYSCAl aeaber, erasing OSERCAfr deleting SfSS¥Ci* and SISOSE 
entries^ and deleting the user froa the CHBOID of the old pool. 

Finally r 30¥EUSEE goes through a cleanup phase to reset any locks that 
were set ^ so that the OSEHID/TOOIIj will be able to logon and his/her 
datasets caa be referenced by other asers. 

a fcWHSG i ijew Upaates for Messaqesl CoitBiand 

This command brings the »ost active messages up to date. 

j-____--_ — _„^__ — _™_™_- » ^ ^ — -.— . ^ ^ __ ^ ^ — ^ J 

fOperaiiionfOperand I 

I— h- ^ — - — ^ ^ — 1 

I . ^ L. . -_ , — . ^ ~- ^ 1 

Mote : There are no operands. 

FitiictiQaal description ; iEi*RS4i reinitializes a table (CHBKSG) in which 
the User Irompter routine naintains the most active messages in the sys- 
tera. All iiessages in the most-active list are cleared, and any subse- 
quent relerence is read into the table from SYSLIB (SYSMLF) and written 

to the user. The aost-active messages in the system are soved into the 

most-act ive-fflessage table in the Dser Proapter's PSECT- 

g-rograaminq Motes : For standard Kessage processing, the systeia searches 
the Oser Proapter^s table for the message before searching SYSSLF. If 
the ftessage ID is located in the table, the message is issued; the User 
Prompter does not search through SYSHLF for any message it finds in the 
buffer. if SYSaLF is edited to change the text of some messages when a 
copy of the message already exists in the table, the message in the ta- 
ble, exi Siting orior to the update, might be issued. 

The SEKM3S command should be issued following any edit of SlSBIsF to 

enijure that current messages are used by the system. 

Kxample : The operator nas edited the system message file (SYSftLF} • He 
added several new messages and modified several existing ones, fo en- 
sure taat all tasks now active in the system will receive current mes- 
sages p he issues the NEWJfSG coaaand . 
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Oser: Eewmsg 

Systeii: Clears out the nost-active-aessage table; sulsecneiit ref- 
erences to tkose messages cause the® to be replaced in the 
buffer table with the current Fersioa of the message and 
written to the user. 

PAi!CL£AR ^ f Clear Page AssiqniieDt T ablel Coaaand 

The PITCLS&S conmaiidl initializes ?lM-for»atted disks aouated on pri- 
vate deviois. fhis frees the data pages f including DSCB pages) tor 
reuse. 



|Operation|Ot>eraEd 

I — h 



IBkTCLEAR |I>£¥IC2=deTice type^?DLII>= {vol time serial nueber | PRIVS.TE} ^ 

r |HIIMO0E=CJfOfiE|BACK} [ ,PAGIiG= {Y | H] ] 



D1?ICE= 

specifies the type of direct access device on which the pack to be 
initialised is mounted. 

Specified as ; 2311, 231*1, 3330, 333B, or 3350. 

▼OLID= 

identifies the volume to be initialized. 

Specified as ; one to six alphameric characters indicating the 
serial number of the volume to be initialized; or PlIfATE if a sys- 
tem scratch pack is to be mounted. 

indicates that the time-shared PITCLBIB is to be run conversation- 
ally or nonconversationally . 



Part III: System Prograamer Comiands 242.7 



TNL GN2C>4106 (01 July 80) to GC2 8-2008^5 



Specii ii ed as ; FOBl or BICE. 

poll - The PlTCLEll is performed ia the user's task wkile nianiag 

conTersat iomallf • 
BACK - iheii specified in a c^oBversational task^ a separate back-- 

groaad task is created to perfora the PIfCLEIl. 

Mote ; EtIIEODB is ignored if issued in a noncoaversational aode; 
the FliTCLEl.1 is perfor«.ed within the background task in which it is 
issued. 

PIGING 

indicates whether a pack is to be initia'.ized for data FPt storaa^ 
or for paging. 

Specif ied as : 

Y - clears the PAT (Page Assianment Table) and indicates that all 
pajes on the pack (except error pages and PAT paaes} are to Ih-^ 
used for paaing« 

M' - iniicates all pages on the pack are -o be used for ca+a set 
storage . 

Defaul t: N 

CAOTIQM ; I'he ¥oliime to be initialized ®Est ba on a private dewice ana 
maj not be in use at the time PITCLEIE is executed* Ike VOLID operacid 
»af not Match any ¥OLID in the public Toluae table (that ±s, fOlID can 
simply be patched ^ using TSSS) - This coaaand can onlf be executed by 
tasks having or P authority, or by the syst^a operator fin the back- 
ground EOHiODE only) • 

Functional Description ; PITCLEifi zeros the one-byte entries and the re- 
location entries in the page assignaent table {PIT) on ¥IM~f oraatted 
disk packs* The one-byte entries in the PAT for the following pages are 
not zeroed: 

The PIT page (s) 
Any eiror pages 
The pages on the error retry cylinder 

Proqraaainq^ Motes ; The user is responsible for interfacing with systea 
services sach as the catalog or external storage allocation; that is,, he 
Must use the saae precautions he would use in reinitializing the pack 
with stand-alone D&SDI |this is especially iaportant for aultiFolume 
data sets) . 

PATFll CFii Page Assignaent Table) Coaaand 

This coaaand validates entries in the page assignaent tables (Plfs) 
by constructing a new PAT froa DSCBs that reside on the specified ¥ol- 
uae, and cc^aparing the reconstructed PIT to the original. I diagnostic 
report shoiing any PAT errors or inconsistencies is then printed on the 
systea printer or recorded in a specified data set* 
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——■ — ~r — — — — " 

Opera tioE | Operand 



I r 1 

I I (2311 ^volume ID,.*-|| 

i f (231%, volume IB, )| 

PITFII I ¥0LDEF=<(3330,voliiBe ID,..«)> [ ^D2?C0IJlT=nwaber ] 

I I (333B, volume ID^«..)| 

f I (3350 ,volii»e ID^..«)I 

I IPOBLIC I 

i 

I [ ^FII=fliM] ][ ^BEP01TDS=^-^ata set naae ] 

I [ ,.I>IAGREF=Yfl] [ |,DAYS=QiiEber] 

L .— .»^._„-___JL. ^ ™-^ . _ — . ----«-_»_»__™„-____— -_---^^ — _ — __ — __-- — . _ _J 

fOLBEF= 

specifies the volumes for wkick the PIT entries and DSCBs are to be 
validated. 

Specified as ; PUBLIC to validate the PATs in all public storage; 
2311, 2314^ 333CI|. J33B|, or 3350 ,r followed bj a list of private vol- 
tt»e serial amabers. Device types cannot be mixed. Public volumes 
•af not be specified bf volmme serial nuaber* 

DE1COOIT= 

specifies the Enaber of direct access devices that are to be msed 
for BOiiating private volnMes; this operaii.d is ignored for public 
volumes. If the specified amaber exceeds the auaber of volnaes a- 
vailable^ as indicated im the user table jr the count froa the user 
table replaces the DE¥C011T specification. If a specified private 
volttme is fomnd already «oiiiited for the curreat task^ the device on 
which it is .aonated becoaes available (if aecessarf} to PITFIX for 
aouEting other private volumes; in such cases BlfCOlIT is antoaati- 
calif increased bf 1 » 

Specified as ; A decimal BOBber* 

Default : fhe number of devices available indicated itt the user 
table. 

spec:ifies whether or not error conditions in the PIT are to be 
fixed. If specified as 1, im a coEversational task ^ the sfstea 
will proapt the user to deter»iae if: 

• Erroneoiis DSCB checksttMs are to be recomputed. 

• Ottused BSCB slots haviB.g nonzero data are to be zeroed. 

• Unused for»at~P BSCBs are to be zeroed* 

• Erroneous foraat-^l BSCBs are to be zeroed. 

• The rebttilt PIT page is to replace the original ooe- 
lE mottconversatioiial tasks, 1 cannot be specified* 
Specified as : I or 1 

Defatilt : 1 

lEPOlTDS^ 

sp^ifies the naae of a previously defined data set ioto which the 
PIT diagnostic report is to be written^ 

2ift 



FIX = 



Specified as s I fiillf qualified data set naae of a ¥S11^ ¥ISIH 
(line data set) , or QSIH (vitkoiit kej s) nev or old data set* 

Defaiilt ; the report is written, using HSIE, on tlie sfstea printer. 

Bote : Onlf an issner having privilege class E naj take the 
default* 

D1I6REF== 

specifies whether or not the •BITISBT UIRIFBIIHCBB XV 91 BUS* aes- 
sage is to be written into the report data set. If the nser is 
only interested in looking at the PITFIX ontpnt for errors, aanj 
■BJlfJlSlf UHBIFEBIICBB* messages will sake it harder to spot any 
error messages in the ontpnt i this paraneter will elininate thea. 

Specified as s f or I. 

Defaults 1 

P1YS« 

specifies the nnaber of days the unreferenced messages should be 
issued for each dataset. 

Specified as s a decimal number from 1 to 999. 

Default s 30 

Functional Description s PJkTFIX searches the DSCB chains of all the data 
sets on the specified volumes, and rebuilds the PIT from the DSCB page 
pointers on those volumes, this search identifies the following error 
conditions: 

• Invalid DSCB entries ffor example, DSBEIT, DSBCHl, DSEIHE, DSETTP, 
DSBCKS) 

• Belocation entry errors 

• On used format -F DSCBs 

• Data page entries not accounted for in a DSCB 

• Invalid PIT control entries 

• Erroneous DSCB entries in PIT 

The search also verifies the DSCB page slot crount. & cromparison between 
the rebuilt PIT and the original FIT is made to discover any discrepan- 
cies between them. If any errors are found and FIX=y was specified, the 
user is prompted for the option to recompute (or reset) checksums, zero 
out unused format -F DSCBs, zero out unused DSCB slots, or to replace the 
old FIT with the rebuilt PIT. Then, depending on the user's specifica- 
tions, diagnostic information indicating all errors found in the PITs 
are written out or the rebuilt PIT replaces the original PIT, or both. 
The diagnostic information written to the output data set make up five 
distinct reports. 

1. PIT Error Beports Indicates PIT control entries (that is, X»7F«, 
X»C0', or X«1F») are either missing, improperly located, or improp- 
erly specified. 

2. Data Set Status Beports lists status information describing every 
data set on all of the volumes specified by the VOLDEF operand and 
flags data sets containing diagnostic or error conditions. Status 
information includes s data set name, date last referred to, change 
date, total number of pages, volume ID, relative page number of 
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DSCB slot^ and tlie slot miaber. Diagnostic and error conditions 
include: invalid checksnis^ invalid foraat-l DSCB^ data set not 
referred to within a specified period, and pages allocated but not 

used. 

3. Shared Data Bage leport: Lists the data set na«e and location of 
anf data sets claining the saae data page (thdLt Is, having the sase 

page pointer in their DSCBs| • 

4. PIf Comparison Data: Lists, for all volniies specified by the ?0L- 
DEF operand, anf unused format -F DSCBs or data pages. 

5« Data Set Profile leport: Lists bf user ID and volume ID all data 
sets and data pages associated with each user ID; thej are listed 
first alphabetically by user ID and then numerically by total num- 
ber of data pages. 

Programming Motes ; This command can be used only by system programmers 
with authority 0, 

The normal procedure for using PITFIX is to issue it once, with 
FIX=I, to produce a diagnostic report, and then to reissue it a with 
FIX=I, to fix the err^or conditions that were indicated in the diagnostic 
report. If a diagnostic report is reguested with the second PITFIX, 
although some of the reports would have been updated to reflect changes 
made via FIX=¥ (for example, the data set status report would reflect 
recomputed checksums if the user had reguested them) , all of the updated 
PIT changes would not be present in the diagnostic messages (for exam- 
ple, in the FIT comparison report, any data pages that were reclaimed, 
or unused DSCBs are still listed as error conditions) . To get a caom- 
pletely updated diagnostic report, a third PITFIX, with FIX=1, should be 
issued. 

When executing conversationally, the user is prompted, prior to writing 
out any DSCBs or PITs, to determine if he wants to make any fixes. 

Ihether public or private volumes are being processed, with FIX=Y, and 
lEPORTDS is also specified, the report data set must reside on a volume 
type other than one specified by the VOLDBF operand. Thus, if public 

storage is being processed (with FIX=Y) , the report data set must be 
mounted on a private volume. 

When processing public storage, with FIX=f, this command should not be 
used while active users are on the system, because all of the PIT 
entries, for all of the public volumes specified, are locked while PIT- 
FIX processing takes place. 

If a user asks to write the PIT while in background mode, the writing 
does take place. 

For the report data set, format-1 records, and logical record lengths 
other than 132, will not be processed. 

If a data set spans to a volume that was not specified by VOLDIF, the 
user will be prompted for continuance; if he responds with Y, the volume 
is added to the volume list specified by VOLDEF, and processing 

continues. 

Examples ; 

1. For public storage, when FIX is specified as Y and the report data 

set has a VSIl organization, you might issue: 

ddef report, vs, report, volume= (, private) ,unit- (da, 2311) 
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patf ix ptiblic^ , j , report 

If the report data set is defaulted # the operator aiist delete a 
printer and enter: 

patfix piiiblic^^f 

For a private voliiae, when FIX is specified as f and the report 
data set has a ¥ISAlf organization, fon might issue: 

ddef report ,vi , report 

patfix voldef=C2311,dp0575) ,devcoiint=1,f ix^y^reportds^report 



I FOOI*? Conaand 

This coamand displays the status and other inforaation concerning all 
pnblic storage pools known to the sjstea. 

f ^"— T • ^ ^ ^ 

I Opera ti on | Operands I 

I 



I POOL? 

I 



I 



yote ; there are no operands. 

Functional description : this coaaand causes a display of the pool's 
status (aaintenance, marked for deletion, etc.), volnae state, and the 
preferred S7SCIT volnae serial nuaber (if any) for each public storage 
pool. 

PBGTF Coaaand 

This coaaand translates the captured trace data into unforaatted but 
printable hexadeciaal characters - 



I Opera ti on t Operand 
I 1- 



I P16TF 
I 



|IlDSl=dsnaael [,0!JTBSI=dsnaae2) C,»B] 



IMBSV 

the naae of the trace data set to be translated. 

Specified as ; a 1 to 35 character naae; the first character aust 
be alphabetic. 

Default : none. 

OOlDSl 

the naae of the output data set that will contain the translated 
trace data. 

Specified as : a 1 to 35 character naae; the first character aust 
be alphabetic. 

P^ault : if defaulted, the translated data will go to the terminal 
only. 



*B 



specifies thait translated data is to go to the terainal as well as 
dsnaae2« 
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Specified as : B 

Def aolt ; translated data will not go to tke terainal. 

raiHf Coma and 

In addition to the PlIIT co&nand operands available to all users (de- 
scribed in Coaaand STSteii User's Guidel , the privilege class E user aay 
choose £roa several tape printing options (the f JkPOPT= operand) . f hese 
options are described in detail under •Printing ISCII Data Sets" in Part 
I. 
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BC= 



HB= 



SECPRE Com an a 

km ^t plana ti on and tlie general format of the SSCIIBE coBnand is con- 
tained in Coaaand Svstea Oser's Snide > Tke operand choices available to 
the prlTilege class B (systeii sonitor) user are described below and are 
in addition to the operands available to all users. All operands anst 
be entered as keyvords; thej aaf not be entered positionallf • 

Fl= 

designates the niiaber of printers requested. 

Specified as ; k one or two digit nnaber. 

Default s lo printers are reserved. 

designates the nnsber of punches requested • 
Siiecified as ; k one or two digit number. 
Default ; Vo punches are reserved. 

designates the number of crard readers requested. 
Specified as ; Jl one or two digit number. 
Default ; lo card readers are reserved. 

Programming Mote ; then reserving devices, all devices must be requested 
in a single SECQIE command stat^ient. For example; 

secure (ta=2) , (pr=1) , C^d=2) 

I SSTBVM Command 

I this command allows the pre-joined user and system administrators to 
I set volume limits for the allocation of new datasets, or extensions to 
I existing datasets. 

J J , 1 J 

I (Operati on {Operands I 

I 1 ^^ 1 

I |S1TE?I |[IIS11ID=,L011¥1«,HIGHEVI=| I 

t I I 

IISEfilD 
I identifies the user for whom If Is are to be set. 

I Specified as ; a userid, or ^kl^L, or *CC. *ILL refers to all 

I use rids Joined to the issuer's pool. ^CC allows a sjst^i adminis* 

I trator to change/display all userids that match the first two 

f characters of his/her userid. 

I D^ault ; the current £¥ls for the issuer's pool are displayed. 

I liOlBTl 

I identifies the lowest relative volume number within the pool on 

t which new datasets or extensions to existing datasets will be aUo- 

I cated for the specified tJSBlIDfs). 

I Specified as ; a one to three digit number. 
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fiI6HlfI 

identifies tke kighest relative volume aamber withia tke pool on 
whick new datasets or extensions to existing datasets will be allo- 
cated for tke specified USlRID(s). 

Specified as ; a one to tkree digit nunber. 

Default : if botk LOWIVI and HIGHBVll are defaulted r tke current 
IVHs for tke specified OSBRIB(s) are displayed. 

lotes: tke Efl lisits aay be expanded but not reduced for any USEllD 
wko is already in HOfSUSBR status* 

Following execution of tkis coaaand any CSSEID datasets wkick may be 
outside tke 1¥I limits are unaffected; tke Efl limits apply only to tke 
extensions of existing datasets or new datasets. 

However^ if a HOVEliSEl command witk POOLID=*POOL is executed follow- 
ing a SBTBTM, any user dataset witk at least a part outside tke R?l 
limits will be copied witkin tke Ifli limits (witkin tke same pool) if 
sufficient space exists; otkerwise^ a diagnostic is issued. Tkis is tke 
•compress* option- If a diagnostic is issued indicating insufficient 
space^ several SEfRVIs may be issued, eack expanding tke RfM limits, un- 
til sufficient space exists. 

TRACE Command 

Tkis command will trace tke instructions of an ICP/PEP or EP. Tke 
trace is simply a record of tke instructions in tke order in wkick tkey 
were executed. 



• 1 ^ — 

I Opera ti on | Operands 



ITRICE Iresource [,BSMlliE=] [,MCPDBS=] 

I ^ 1 



resource 

identifies tke resource to be traced. 

Specified as ;- a 1-8 ckaracter name, tke first ckaracter must be 
alpkabetic. Tkis name must also be tke name of a region in tke 
TSS*****.SfSRCS dataset. 

Default ; Tkere is no default for tkis parameter. 

DSMAIB 

tke name of tke dataset tkat will contain tke trace output. 

Specified as ; a one to tkirty-five ckaracter name- Tke first 
ckaracter must be alpkabetic. iote; If tkis parameter is omitted, 
tke output will go only to tke terminal. 

iCPDES 

directs tke output to tke dataset only or to tke dataset and tke 
terminal. 

Specified as ; ID for output to tke dataset only or LDT for output 
to botk tke dataset and tke terminal. 

TRACEMD Command 

Tkis coamand will terminate a trace that is active » 
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I I Opera ti oa | Operands 



I ITBICEMB |TllCID=trace identification 

I 1 .. ^ 



I TIACID identifies the trace that is to be terminated. 

I Specified as ; a 4 digit niiaber. 

I Def attlt : fhere is no default for this parameter. 

PPPTIISEB COpdate User fables! Coamand 

The IBBfOSEB coitmand causes the data aboot the use of external 
storage, currently in each user table, to be updated with the informa- 
tion froa each user's catalog and DSCB entries. 



I 1 

I Opera ti on | Operand 



lePDTUSBl |[MODE={JI|S} ] 

1 ^ I — . ^ . 



KOBE 

specifies whether all or selected user entries in the SISUSB data 
set are to be updated. 

Specified as ; k - all 

S - selected (onlf entries for users with acti¥e 

tasks or owning shared data sets that are being 
used) 

Default ; I 

Functional Description ; this command enables privileged sfstea prograa- 
aers having an O amthoritj code to update all user tables in SISOSB, 

with usage statistics froa various user catalog entries. 

If mode S is sp€?cified, only those entries for active users or for 
those with shared diata sets in use at the time of issuing OPDTOSEfi (or, 
if the system failed and was restarted, users active at the time of sys- 
tea failure) are updated, k flag (O'SBIDC) is set on in the user entry 
for active users; if S is specified, only those entries with this flag 
on are updated. 



Froqraaainq Hotes ; OFDTCJSER erases temporary public data sets and 
updates the total nuaber of pages associated with each user table in 
SfSUSE. 

UPDl'OSBE should be issued after each re --creation of public storage 
caused by issuing IPS or C?¥ commands and at any time the user tables 

are suspected of being incorrect- 

If the user table is suspected of errors for active users only, such 
as might be the case following a system failure and restart, the use of 
mode S mignt reduce the updating time. 

ihen the user table of the task issuing the OPDTOSEE cx>ffiEand is up- 
dated, the shared virtual storage record of that user table is updated 
to correspond to the updated SISUSE record resulting from execution of 
yPDTIiSEl . 
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EXAMPLE ; 

User: ttpdtaser 

System: Returns the following message to STSOUT: •nnnn USEE TABLE 
SfOlAGE ALLOCATIOWS UPDATED AG AIM ST DSCBS". 

OSAGE OOttttand 

See the Coaaand System Oser"s Guide and, for determining usage of the 
system by users other than the USAGE issuer , the Hanaaer's and Adminis- 
trator's guide > 

▼PHP Command 

This coaaand will print on the system SYSOUT device one to all pages 
of a ?AH data set, object text, all the DSCBs for a data set or all the 
DSCBs on the given volume (s) • 



, 

I Opera ti on | C^er and 

1 

IVDHP I DSirA!IE=data set name 

I [ , CEI Al!E=cont r ol secti on name ] 

l[,DSTXPB={DS|OBJ|DSCB} ] [ ,OPPSET=page offset] 

i[ ,COUirT=number of pages] 

I [,?0LDEF= {PUBLIC I (device type, volume identification 

I [, volume identification])}] 

I I 

DSIAHE 

identifies the data set to be dumped or the data set of the DSCB to 
be dumped- The data set must reside on direct-access storage. 
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¥11 iata sets must be cataloged unless xhB VOLDIF parameter is 
specified. 

Specified as ; a fmllf fualified data set mase with (optioaally) a 
generation number and/or aember naae of a ¥FA1I data set. Iken 
specified y the aeaber name is enclosed in parenthesis and i»«e- 
diatlelj follows the VPIM data set name. When VOLDEF is specified, 
the DSHAIE must be prefixed by the USllID. Otherwise , the OSBIID 
is not used. *ILL is used in combination with DSCB and fOLDlF 
parameters for the given volume (s) . 

CEHIIE 

identifies the control section or entry point of object text to be 
dumped. CSHIJiE is to be specified only for DS!!!yFE=OBJ. When spec- 
ified, member name is ignored. 

Specified as : a control section name. 

DSTYFE 

specifies the data type to be processed. 

Specified as ; 

DS - data set 

OBJ - object text 

BSCB - data set control block 

Default: OBJ is assumed. 

OFFSET 

specifies the page offset from the beginning of the data to be 
dumped. For DSTIPE^DSCB, the OFFSET parameter is ignored. 

Specified as : to (2**-l)in decimal digits or the eguivalent 
guoted hexadecimal value with preceding •X». Arithmetic expre- 
ssions may be used (maximum of 20 characters) • They should be of 
the same format as TSSS and PCS and should be expressed in pages. 
See Example 4. 

Default ; is assumed. 

COUIT 

identifies the number of pages to be dumped. For DSTTPB=DSCB, the 
COUMT parameter is ignored. 

Specified as : 1 to 20,000 in decimal digits or the eguivalent 
guoted hexadecimal value with preceding "X*. Arithmetic expre- 
ssions may be used (maximum of 20 characters) and should be of the 
same format as TSSS and PCS and should be expressed in pages. 

Default : all of the control section, data set or associated DSCBs 
are assumed. 

VOLDEF 

identifies specifically the volume (s) to be searched for the data 
set with a maximum use of two volids. The use of the ¥OLDBF param- 
eter will clause the catalog entries for the DSIIAHS to be bypassed. 

Specified as : 

PUBLIC - for searching all public volumes. 

(device type, volume identification [, volume identification]) - 
for partiizular volumes or a volume to be searched, 
device type - 2311, 231i|, 3330, 333B, 3350. 

volume identification - a valid volume XD consisting of 1 to 6 
characrters. 
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PuRctlonal Pescrlption : The fDHP coBsancI daaps the referenced object 
text, data set or all BSCBs. The user may specify the dump data set he 
created on his own private Tolaae (disk or tape) hy entering DIFIOLTS 
commands for OVIT, TOItflHl and LJIBEI* parameters to be nsed in the TIHACC 
DDIF. For a non-conversational task a SICORS command must be issued by 
the user immediately following the LOGOV command » The dump will begin 
with an appropriate heading* Each line of the dump will contain 32 
bytes in hexadecimal character formats. It the beginning of each line 
will be the displacement. For data sets, displacement indicates the 
byte offset from the beginning of the page, displacement indicates the 
offset from the beginning of the control section for object test and 
from the beginning of the DSCB for a BSCB dump. When dumping object 
text, if a null page is encK>nntered, the displacement is incremented by 
i|096. 

CIPTIOH ; The use of the ¥OLDEF parameter will significantly slow down 
the search for the data set. When the VOLDBF parameter is specified, 
the absolute generation name must be used. 

Programming Mote ; Only authority •D^ users may use the VOLBEF parame- 
ter. In addition, nse of the ?OI»BEF parameter is to be msedL only when 
the data set cannot be accessed in any other way. 

for privileged system programmers, *JII.I. as a BSIIHE regnests all BSCBs 
for a given volume. If DS1IIIE=*ILL, the VOLDEF parameter mast be 
specified. 

Authority •IF» will only be able to dump OBJ {object text) while 'O* and 
•P» authorities may also dump BS and BSCB- 

Example ; Example 1 dumps on the system SYSOUT the first 23 pages of the 
first generation of 1BI1 of I.B.C.B. Instead of the catalog, all public 
volumes will be searched. 

VBIP TSS*****.1.B.C.D.G0OO1VOO (lEll) ,,BS,, 23, PUBLIC 

Example 2 dumps on the system SISOBT the first page of the CSECT, TEST 
of joblib. Instead of the catalog, volumes k and B on a 2314 are 
searched for the object text. 

VDMP V0I.DEF=(2314,1,B)C0B1T=1,BSH11E= 
TSS*****. JOBLIB, CE1I1HE=TEST 

Example 3 dumps on the system SISOOT all associated BSCBs of IBC.BEF. 

VDHP IBC.BEF, ,BSCB 

Example 4 dumps on the system SISOBT the fifth page of the data set 
BSEl. 

VBHP USE!,, BS, 5,1 



¥BSP Command 

This command will display on the user's SISOBT device up to 22« bytes 
of data from a VIM data set or up to 10,000 BSCBs from a BSCB chain. 
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Operation | Operand 

1 ^^ 

7DSP |BSlAHB-(lata set name 

|[ ,CllIHl»(coiiti:ol section nanelentrj point nane} } 

|[^DSfIPl=(BS|OBJ|DSCBJ ] [ ^OFf SBT^bjte offset] 

|[ ,COUlT-=nttnbei: of bftes] 

|[^V0LD1F=* {PUBLIC I (device type,voliiBe identification 

I [ ,volnne identification ]) } 1 



nsiAHl 

identifies tlie data set to be patched or the data set nane of the 
BSCB to be patched. The data set anst reside on direct-access 
storage. ¥AH data sets nnst be cataloged unless the 70I.niP paoine- 
ter is specified. 

Specified as s a fully qualified data set naae vith (optionallf) a 
generation nniiber and/or neaber naae of a TPAH data set. When 
specified, the aesber name is enclo^d in parenthesis and iane- 
diatlely follows the TPAH data set nane. When fOLDEf is specified, 
the DSliei anst be prefixed bf the USEIID. Otherwise, the USEIIB 
is not used. 

CllAHl 

identifies the control section or entry point of object text to be 
patched. CBIAIB is to be specified only for nSTfPl»OBJ. When 
specified, aealier naae is ignored. 

Specified as s a control section naae, or an entry point name. 

nsTYPl 

specifies the data type to be displayed. 

Specified as s 

DS - data set 

OBJ - object text 

nsCB - data set control block 

Defanlt s OBJ is assumed. 

OFFSSf 

specifies the byte offset froa the beginning of the data to be 
displayed • 

Specified as s to (22»-l) in decimal digits or the egnivalent 
hexadecriaal valne vith preceding ■X» if DSTTPE^OBJ or DS. For 
BSTIP1=DSCB, OFFSET is specified as to (4096 x 633) -1 in decimal 
digits or the egniwalent giioted hexadecimal Talne with preceding 
*X* • Arithmetic expressions may be used for all types (maximnm of 
20 characters) and they should be of the same format as TSSS and 
PCS and may be expressed in pages pins the number of bytes into 
that page. (Side Example 1.) 

Def anlt s is assumed. 

CO01T 

identifies the number of bytes to be displayed. 

Specified as s 1 to (20,000 x 4096) in decimal digits or the eguiv- 
alent quoted hexadecimal value with preceding *!*, if BSTIPE-BS or 
OBJ. For BST¥FE BSCB, COIIIT is specified as 1 to (633 x 4096) in 
decimal digits or the equivalent quoted hexadecimal value with pre- 
ceding *X*. Arithmetic expressions may be used for all types (max- 
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imuii of 20 characters) but should be o£ the saae format as TSSS and 
PCS. 

Default : 16 is assumed. 

fOlDEF 

identifies specifically the volamefs) to be searched for the DSCB 
with a naxiBUK use of tvo volids. 7he use of the ¥OLBSF parameter 
will cause the catalog entries for the BSH&HB to be bypassed. 

Specified as ; 

PUBLIC - for searching all public volumes • 

(device type^volume identification [, volume identification]) - 
for particular volumes or a volume to be searched, 
device type - 2311^ 231<l, 3330, 333B, 3350. 

volume idei^tification - a valid volume ID consisting of 1 to 6 
characters. 

Functional Description : The VDSP command displays the referenc:ed object 
text, data set or DSCBs on the user^s SIS007. Each line displays first 
the displac^ement and then 16 bytes in both hexadecimal and character. 
Ill unprintable characters will be represented as periods. 

For data sets, the displacement field (from the beginning of the page) 
is displayed as 8 bytes and as 4 bytes for object text. If a null page 
is encountered within object text, the displacement will be incremented 
by 4096. For DSCBs, the displacement will be shown in 2 bytes indicat- 
ing the byte offset from the beginning of the DSCB. 

CAOflOM r the use of the VOLDSF parameter will significantly slow down 
the search for the data set. When the ?OLDEF parameter is specified, 
the absolute generation name must be used. 

Programming Bote : System default for BELBISB will be applied for 
internal DDEFs. Only authority •0» users may use the VOLDBF parameter. 
In addition, use of the VOIDBF parameter is to be used only when the 
data set cannot be accessed in any other way. 

luthority •!!• may display only object text while authorities "O^ and 'P* 
may also display data sets and DSCBs. 

Example : Example 1 displays on the user's STSOOT 50 bytes of data set 
JLBC starting at the 101st byte. 

fDSP IBC,,DS, 100,50 

Example 2 displays on the user^s STSOUT 64 bytes of the type E-DSCB of 
SOURCE .1X2. starting at the 37th byte. Instead of using the catalog vol- 
ume DB584 on a 2311 is searched for SOUBCE.XTZ. 

VDSP irSS*****.S0UECE.XTZ,V0I.DEF=(2311,DB584) , 
DSTYPE=DSCB,OFFSE1?=X»24»,COOMT=X«40* 

Example 3 displays on the user^s SYSOOI^ the 1st page of object text 
TBS11 of USEELIB. 

VDSP USESLIB, TEST 1,C0DHT«X» 1000* 

Example 4 displays on the user^s STSOUT the 6th page of object text COHH 
of USEBLIB at a byte offset of 50 into that page. 

VDSP USEE LIB, COHH,, 5 X 4096 ♦ 50VHEREP 
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VPAf — Ccmaaad 

fhis command will cause the referenced data set^ DSCB or object text^. 
to be updated with up to 50 bytes of data froM the user»s srsiM. 



I 1 

Operati on f Op erand 



fPIt |DSMllHE=dcita set name 

I [ ,CEM&ME== {control section namefentrj point name}] 

|[^I>STYPB=={DS|0BJ|BSC:3} ] [ ,OFFSlT=byte offset] 

|[ ,COOirT=nuaber of bytes ],DITI=replaceaent string 

|[ ,VOLDEF==p*OBLIC| {device type^volmae identification 

t [ ^volume identification ]) } ] 



BSHIME 

identifies the data set to be patched or the data set name of the 
BSCB to be patched. The data set must reside on direct -access 
storage. ?1M data sets must be cataloged unless the ?OLDEF parame- 
ter is specified. 

SpeciJiied as : a fully gualified data set name with (optionally) a 
generation nukber and/or member name of a ¥P1M data set. When 
specified, the aenber name is enclosed in parenth:3sis and imme- 
diatleiy follows the ?PAM data set name. Ihen fOLDEF is specified , 
the BSBAME must be prefixed by the OSEEIB. Otherwise, the USEBID 
is not used. 

CEMAME 

identifies the control secrtion or entry point of object text to be 
patched. CEIAIE is to be specified only for BSTyPE=OBJ. ihen 

specified, aetiber name is ignored. 

Specified as ; a control section name, or an entr? point name. 

BSTfPE 

specifies the data type to be processed. 

Specified as : 

BS - data set 

OBJ - object text 

BSCB - data set control block 

Bef ault ; OBJ is assumed. 

OFFSET 

specifies the byte offset from the beginning of the data to be 
patched. 

Specified as : to (22^-1) in decimal digits or the eguivalent 
hexadecimal value with preceding •X* if BSTIPE=OBJ or BS. For 
BSTYPE=BSCB, OFFSET is specified as to (4096 x 633) -1 in decimal 
digits or the equivalent guoted hexadecimal value with preceding 
•X* . Arithmetic expressions may be used for all types (maximum of 
20 characters) and they should be of the same format as TSSS and 
PCS and may be expressed in pages plus the number of bytes into 
that page. (See Example 4.) 

Bef ault : is assumed. 

COHIT 

identifies the number of bytes to be patched. 
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Specif lei, as ; 1 to 50 io deciiial or tlie egnivalent gnotet hexadec- 
iiial valtte witli preceding •!•• Iritliaetic expressions «af be used 
feaxiMUB of 20 characters) and be of tlie same foraat as TSSS and 
PCS. 

Defanlt: tlie length of the data field is assumed* 

Difl 

designates the data string that is to be the replacement. 

Specified as ; a quoted hexadecimal or character string with a pre- 
ceding »!• or fC». 

fOLBEF 

identifies specif icallf the volnme Cs| to be searched for the BSCB 
with a maximum nse of two Tolids. The use of the fOLBEf parameter 
will cause the catalog entries for the DSllIE to be bf passed. 

Specified as ; 

PUBLIC - for searching all public volumes • 

fdevice tfpe ^volume identification [ ^Tolnme identification]! - 

for particular volumes or a volume to be searched. 

device tfpe - 2311^ 2314, 3330, 333Bir 3350. 

volume identification - a valid volume ID consisting of 1 to 6 

characters* 

Fttnctional Description ; The fPlT command replaces on the disk up to 50 
bftes with the data entered on the ttser»s STSII device. If the length 
of the entered data string is different from the length specified in the 
COUIT parameter, it will be padded or trnnctaed. Character data will be 
padded with blanks or truncated on the right; hexadecimal data will be 
padded with zeros or truncated on the left. If DSTfPl=DSCB|r the CHICK- 
SIM will be automaticallf recomputed. 

CIPTIOI ; The use of the fOlDEF parameter for D STIPE =DSCB will signifi-- 

cantlf slow down the search for the DSCB. 

Since no check will be performed for the validitj of the patch, the user 
should exercise extreme caution. Patching across DSCB boundaries is not 
allowed. 

Programming lote ; Only authoritf 'O* aaf patch DSCBs, DS and OBJ while 
■0" authorities maj patch OBJ and •?» authoritf aaj patch DS and OBJ. 
Onlf amthoritf 'O* msers maj patch sfstem data sets. 

Only authority 'O* users may use the fOlDEF parameter with DST1PE==DSCB. 
In addition, use of the VOLDBF parameter is recommended only when the 
DSCB cannot be accessed in any other way. The patching of shared ¥PIH 
POD is not allowed. 

The system default for HE¥IE1 is applied for the display of the string 
prior to the patch. If RBVIEl-Y, the user is prompted for continuation. 
System default for lELBASB will be applied for internal DDBFs. 

Example ; Example 1 replaces the first 3 bytes of the 533rd page of the 
data set XYZ with the character string •DEF*; 

fPlT X1Z,,DS,1«21%000»,3,C«DEF« 

Example 2 replaces the first % bytes of the 3rd DSCB associated to 1TT11 
with X •00040301 •; 

fPIT DSM1B=1TT11,,DSCB,X»200,X«0«I0301» 
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Ezmaple 3 patches the object text at mntTj point 1F1 of the Beaber T1S7 
in USBBLIB. It replaces 3 bftes starting 4098 bftes past entcj point 
1F1 with ABC: 

fPIT USBlI,IB^lPl^^«l098p3rX»CtC2C3» 

Izanple 4 patches the 5th page of a iata set IBi at 100 bytes into that 
page: 

¥FIT lli^,DS,4 X «IOf6+100^3,C»l»0» 
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AgPEMDIl kt SISTEE EMfER CODE TABLE 



f ■'■ - -1 


1 ' '"1 




1 1 




1 Deciaa 1 


1 Hex 


1 Hase 


1 EN TBI POINT 


1 PSECf 1 

1 1 






1 TABII/HTT/PPLI 




1 ^ 

[ r 


1 


I 00 


1 READ/WRITE 


1 C2CTM1 


1 CZCIIPI 


1 1 


1 01 


1 BATCH ROHITOE 


1 CZ&BAE 


f C2ABAEI 


1 2 1 


1 02 


GATE HACBOS 


C2PT1U 


1 CZFTPPI 


1 3 


1 03 


1 BEADQ 


1 CZCTC3I 


1 CZFTPPI 


t fi 


1 04 


HRITEQ 


1 CZCTCftI 


1 CZFTPPI 


1 5 


1 05 


1 FIHDQ 1 


1 CZCTC2A 


1 CZFTPPI 


1 6 


1 06 


1 FBEEQ 


1 CZCTC6A 


1 CZFTPPI 


1 7 


1 07 


1 ATTEHTIOM 


( CZFM 1 


1 CZFAAPI 


1 8 1 


1 08 


TEHMPEO 


CZFTE15 


1 CZFTPPI 


1 9 


1 09 


PPII BOOTIMES 


1 CZFFLl 


1 CZPPLPI 


1 10 1 


1 OA 


1 BTT/HTTDCS 


t CZFAH3 


1 CZFAHPI 


1 12 


OC 


OPHDST/CLSDST 


CZFTF2 


CZFTFPI 
1 1 


1 1U 


OB 


GBTDV 


CZITM2 


1 CZATHPI 


1 15 


OF 


SETDV 


CZIMl 


1 CZATHPI 
1 ■ 






IHTEBEOPT HAHDLIH6 




1 f 
1 1 


1 16 i 


10 


SIB 


CZCJSl 


1 CZCJSPI 


1 17 


1 11 


1 DIB 


f C2CJDA 


1 CZCJDPI 


1 18 1 


1 12 


1 IHTINQ 


1 CZCJII 


1 CZCJIPI 


1 19 


13 


STIBEE/TTIHER 


CZC JA 1 

1 


1 CZCJARI 
1 1 






1 SAM 1 




1 1 


f 32 


20 


1 BEAD/WBITB 


[ CZCIIS 


1 CZCfiAPI 


1 33 


1 21 


CHECK 


[ CZCECS 


1 CZCICPI 


1 34 


1 22 


CNTBL 


[ CZCEBS 


1 CZCRBPI 


1 36 1 


1 24 


POIHT 


1 C2C1H1 


1 CZCBHPI 


1 37 


25 


BSP 


CZCRGl 


CZCIGPI 
1 • 






?H ALLOCATION 




1" f 

1 1 


1 48 


30 


1 GBTMAIH (R) 


1 CZCH2 


1 CZCG5 1 


1 49 1 


1 31 1 


GETHAIK (PAGE) | 


1 CZCG2 


I CZCG5 1 


1 50 


1 32 


1 FBEEMAIH (B) 


CZC13 


1 CZCG5 1 


1 51 


1 33 


FBEEKAIN (PAGE) 


CZCG3 

1 


1 CZCG5 1 
1 1 






1 »AH 1 


' 


I 1 


1 56 


38 


1 TDHEP 1 


CZCQK 1 


1 CZCQKPI 


1 57 1 


1 39 1 


DOPOPEH 


1 CZCEY1 


1 CZCBYPI 


1 58 1 


1 3& 1 


DUPCLOSB 1 


1 CZCBZ1 


1 CZCEZPI 


1 61 1 


1 3D 1 


▼ISAM SETL 1 


I CZCPC3 


C2CPC3I 


1 62 


1 3E 1 


1 ?SAH PUT 1 


1 CZCOS3 


1 CZC0S3I 


1 63 1 


1 3F 1 


LIBESBCH 


CZCDL3 


1 CZCDLPI 


1 64 1 


1 40 


BEAD/IRITE 


CZCPEl 


1 CZCPEPI 


1 65 1 


1 41 1 


1 SSBTL 


CZCPD 1 


1 CZCPIPI 


1 66 1 


1 42 1 


BELEX 


1 C2CPG1 1 


1 CZCPIPI 


1 67 1 


43 1 


DEL B EC 


CZCPHl 


CZCPHPI 


1 68 


1 44 1 


FIHD 


CZC0J1 


CZCOJPI 


1 69 1 


45 1 


STOW i 


CZCOKI 1 


CZCOKPI 


1 70 1 


46 


ADD DIBECTOBY EHTHY 


1 CZCPLt 


1 CZCPIPI 


1 71 1 


1 47 1 


GETPAGE 


[ CZCPI1 


1 CZCPIPI 


1 72 1 


48 1 


IHSEBT PAGE | 


CZC0D1 1 


CECODPI 


1 73 1 


1 49 


DELETE PAGE 1 


CZC0D2 


CZCODPI 


I 74 1 


1 41 


1 ?SAB POT EXTEElfAL OSEB | 


f CZC0S1 1 


f CZC0S1I 


1 75 1 


4B 1 


▼SAM PUT IMTEEHAL | 


CZC0S2 1 


CZC0S2 1 


1 76 1 


1 4C 


BOVEPAGE 1 


czccm:i 


CZCOCP 1 


1 77 1 


1 4D 1 


1 FLOSHBOF 1 


1 CZCOfI 1 


CZCOVPI 


1 78 1 


4E 1 


1 ▼ISAM GET PAGE IHPOT | 


CZCPI2 1 


CZCPIPI 


1 79 1 


4F 1 


▼ISAM GET PAGE OOTPOT ] 


1 C2CPI3 1 


CZCPIPI 
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1 1 1 — "- ■ "1 1 "I 

1 BeciMal | Hex | la«e I BITRf FOIIT f FSECf | 
III III 


1 1 1 MACRO COHHAIB LAIGOAGB 1 1 1 
1 80 1 50 I GATRB/GATIR | CZATC2 | CZATCF | 
1 81 I 51 1 ITO 1 CZABQ1 | CZABQR | 
{82 1 52 1 WTOR I CZABQl | CZABQR | 
1 83 1 53 1 ERASE 1 CZAEJ7 | CZAEJR | 
1 84 1 54 1 BBSF 1 CZAEA3 { CZAEAR| 
1 85 1 55 1 CBB 1 CZAFS2 | CZAFSR | 
1 86 1 56 1 ABEIB I CZACFI | CZACFRJ 
1 87 1 57 1 CFB 1 CZABB7 | CZABBR | 
1 88 1 58 1 IT f CZABB9 | CZABBR | 
t 89 1 59 1 FR 1 CZABB3 | CZABBR | 
1 90 1 5A 1 CAT 1 CZAEI2 | CZAEIR | 
1 91 1 5B 1 BEL 1 CZAEJ5 | CZAEJR | 
1 92 1 5C 1 COFIBS f CZAFf2 | CZAFfR | 
i 94 1 5E 1 WTL 1 CZABQl | CZABQR | 
1 95 t 5F 1 PSATT I CZASA6 | CZASAF | 
1 96 1 60 1 FllBJFCB | CZAEBI | CZAEBR | 
1 97 1 61 1 CLATT I CZASA7 | CZASAF | 
1 98 1 62 t IBL 1 CZAFJ2 | CZAFJR | 
1 99 1 63 1 USAGE I CZAGB1 | CZAGBF | 
i 100 1 64 1 FllBBS 1 CZAEC1 i CZAECR { 
1 101 1 65 1 HSGIR 1 CZAAB3 | CZAABR i 
1 102 1 66 1 UFBTUSER | CZAGC2 | CZAGCR | 
III III 


1 110 1 6E I GRAFIIC BUFFERS | CZCfBl | CZC¥BF| 
1 111 1 6F 1 GRAFHIC I/O | CZC¥E1 | CZC¥EF| 
Iff t It 


1 1 1 GEIERAL SEptlCES | | | 
1 112 1 70 1 lORBQ 1 CZCSB1 | CZCSBRj 
1 113 1 71 1 ISAM REAB/WRITE | CZCIFI | CZCIFF | 
1 114 1 72 1 ISAl - SET OUT RKTORB | CZCIBl | CZC1BF| 
1 115 1 73 1 ISAl FIIISH | CZCIHl | CZCBHF| 
1 116 1 74 1 TSAI RBAB/IRITE/FHISH | CZCXC3 | CZC1C3| 
t 128 1 80 1 OLTAl - BE¥. ALLOC. | CZATGl | CZATGFf 
1 129 1 81 1 OLTAI - EX. I/O | CZATAI t CZATAFf 
1 130 1 82 1 OLTAI - WOSTIWQ | CZATBl | CZATBFf 
1 131 1 83 1 OLTAI - TEST COIIAIB | CZATSI | CZATSF| 
1 144 1 90 t OFEl 1 CZCLAO | CZCLAB| 
1 145 1 91 1 CLOSE 1 CZCLBC | CZCLBF| 
i 146 1 92 1 FEOV | CZCLBF | CZCLBB| 
1 147 1 93 1 RFR i CZASB3 | CZASBF | 
1 148 1 94 1 GB¥ | CZASBI t CZASBF) 
t 149 1 95 1 AETB i CZASB5 f CZASBF | 
t 150 1 96 1 OBSf 1 CZASA4 | CZASAFf 
1 151 1 97 1 ICAST 1 CZATBl | CZATUF] 
1 152 1 98 1 SYSIl 1 CZASC7 | CZASCF| 
1 153 1 99 1 LFCIIIT | CZASlI | CZAIZF| 
1 154 1 9 A 1 LFCEBIT | CZAS14 | CZAIZFf 
1 155 1 9B f FRIFT | CZATSI | CZATJF| 
1 156 t 9C 1 ATTl 1 CZASB2 | CZASBF | 
1 157 1 9B 1 GATE | CZATC2 | CZATCF | 
f 158 1 9E f EITIFR | CZASB5 | CZASBF | 
1 159 1 9F I BELEIT | CZASB6 | CZASBFf 
1 160 1 AO 1 CSTORE I CZCKZI | CZCKZF | 
1 161 f A1 f IITRFR 1 CZASB4 | CZASBF | 
1 162 1 A2 1 BICTI01AR7 HAIBLSR | CZASB2 | CZASBF | 
1 1 1 III 


1 I 1 FOBTH^W 1 1 1 
1 164 1 A4 1 FTH TRACEB&CK t CZCDTl | CZCDTPi 
i 191 1 1 Reserved for TSS osers. | f I 
1 254 II ill 
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IPPBMBIX B; fIBTOAI. IHB REIL HgHOlY S?CS 



In this appendix, the BCL&SS setting shows what BCLISS operand is re* 
gnired when assenbling the aacro instr notion. Where no BCLASS setting 
is shown, there is i|o regnireaent; that is, the macro definition does 
not test for a BCLISS setting. 



MOI-PRI¥ILEGEB PBOGBAi SERVICE S¥CS 

I ' 1 ^ 1 



1 1 

I COBB I 
BCLISS I RQMT I 



SVC COBB 
BBC HEX 



MACRO 



FBHCTIOI 



0-99 00-63 



RESBRVBB FOR PROBLEM 
PROGRAMS 



I 



PRIflLBGBB PROGRAM SBRflCE SVCS 



1 s?c 

I DBC 


1 

CODE ! 
HEX 


MACBO 


■ •■ " ■ 1 

FUICTIOI 


BCLASS 1 


r ■ T 

1 COBB I 
RQHT 1 


r 100-115 


6ft-73 


» * * 


lOT BEFIMBB | 


... ! 


... 1 


I 116 


7H 


BXM 1 


lORMAL PROGRAM BIB 


USER 


HP 1 


1 117 


75 


RABSfC 


RESTORE AlB ElABLE 
IWTERROPTS 1 


USER/ 
PRIV 


HP,P 1 


1 118 


76 


CLIP 


REAB COHMAIB FROM SISIW 
(BlICOIBITIOBAL) | 


OSER 


HP 1 


1 119 


77 


CLIC 


REAB COHMAIB FROM SfSIl 
(COHBITIOHAL) 1 


1 0SER 


IP 1 


1 120 


78 


1 RSPRV 


RESTORE PRIVILEGE 


USER 


IP 1 


1 121 


79 


BITER 


BITER PRIVILEGEB ROBTIITB 


... 


IP 1 


1 122 


7A 


RTRl 


BBTER COMMAIB LAIGBAGE 
TO ElB RIIW 


... 


IP 1 


1 123 


7B 


BELET 


EITER BELETE PROGRAM 


... 


i IPrP i 


1 124 


7C 


1 ... 


I lOT BEFIIEB 


1 ... 


I ... 1 


1 125 


7D 


1 PCSVC 


1 BITER PCS 


1 PRIV 


IP r 


1 126 


7E 


1 ... 


1 HOT BEFIBEB 


... 


• . • 1 


1 127 


7P 


I BLIIK 


! BBTBR BXIAHIC LOABER TO 
j RESOLVE EXTERIAL SIMBOL 


1 ... 


\ Mp,p r 



Figure 39. Virtual and Real Meaory SVCs (part 1 of ^} 



2Si| 



SEAL iMOHI PROGSIi SBiflCE SWCS 



1 ^ ^ — 1 

1 S¥C COBE 1 
1 DEC HBX 1 


IflCEO 1 


POMCTIOH 1 


DCLASS 1 


" ' "I 

CODE 1 

RQHT 1 


1 128- in 3 


80-8F 1 




SESEEfED fOH | 
IlSTALLATIOl USE | 


j 


t 


1 1i**l-15e 


90-9B 




Bf!SEl¥B0 FOB TSSS | 


..• 1 


... 1 
1 


1 159 


9P 




fSS »AT« IK NOM-SHIEID ?H | 


... 1 


IPrP 1 


1 160 


10 




LOGOi ESP ! 




P 1 


1 161 


A1 




DISCOMSECT MS? 1 




P 1 


1 162 


A2 




ACTIfAfB fSS 1 




P 1 


1 163 


1,3 




fSS 'AT* CORPLETl j 


... ' 


«P#P f 


1 164 


&4 




^SS ^AT» II SaAlEB fH i 


j 


iP,P 1 


1 165 


45 




GEf EEAL PAGE | 


• • • 1 


P 1 


1 166 


16 




SHARED PAGE DETEEilSATIOSI 




P 1 


1 167-16 9 


I7-A9 




RESBITED ?0E TSSS 1 




... t 


1 170-17 9 


AA-B3 




MOT DEFINED | 




... 1 


1 180 


B4 


ESSG 


RSSEEfE SEGEiSif 




»P,P f 


1 181 


B5 


BILSBG 


RELEASE SEGMEST 




SP,P f 


1 182 


B6 


DSEG ! 


DISCOIMECT lAHBB SEGHEIT 




iPfP i 


1 183 


B7 


\ CSEG 


' COM»ECT MARED SEGIEIT 




»P»P 1 


1 184 


fl8 


i DILSEG 


DELETE HAIED SEGBEIT 




' IP,!' ! 


1 185 


B9 


1 ESEG 


EXCHAMGE SESWBHT 




ip,p 1 


1 186 


BI 


1 GPS EG 


1 GET/PUT MAMED SEGIEIT 




' ip,p I 


1 187 


BB 


! OFiOi 


■ EITIACT PLOi IIFOIEATIOI 




! P 1 


1 188 


BC 


; SETCTL 


SET COITEOL BEGISTBIS 


PRIf 


IP 1 


1 189 


BP 


i XTlCfL 


EXTBACT COiTBOL EBGISTEBS 
1 


• » • 


IP 1 


1 190 


BE 


1 BfTCTL 


\ REAL TIHE COfTROL 


\ PRIf 


' p 1 


1 191 


BF 


f ..• 


\ HOT DEFISEB 


' 


... f 


1 192 


CO 


1 


1 GTF TBACE BEQUEST 


... 


p 1 


1 193 


CI 


( SIHPLE 


r 

1 SAMPLE SST 
1 


! ... 


' p f 


1 194 


C2 


1 ZEEOSST 


f 

1 ZEHO SST 


i ... 


1 p 1 


1 195 


C3 


1 kTTkCn 


f ATTACH TASK TO SISTBM 
i 


... 


t IPrP 1 


1 196-19 9 


C4-C7 


\ 


1 R£SBR?BD FOR PESFORIAICE 

HEASOBBHEIT 
i 


f ... 


1 " .• 1 


f 200 


C3 


\ 


1 UPDATE SYS OPERATOR TABLE 
1 


[ ... 


1 P 1 



Figure 3!t. firtoal and leal Keaorf SfCs (part 2 of 4) 
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TNL GN 20-4 1.06 (01 July 80) to GC2 8^2008-5 



■jr:Al r.£'SOt^.l PROGf^iH SEMVICI: SfCS 





S¥C 


~ — • 1 

CODE 


r— ^ — ^ 

HACKO 


! Fai;cTiO!4 


r" — ~" — ~— 1 

DCLASS 


! ^ — 1 

f CDDL f 




20 1 


C9 


• • . 


:^0T DFFISL^D 


r^ — ^ 


• • • t 




zO?. 


CA 


flMSfC 


aOLTI FlJ!ICTIO>: ^rAMil S¥€ 


... 


P f 




20 J 


CB 


' CKhLQC 


i CHFCK F.?T ITS^l-iAL STATUS 


^ PL It 


t P 1 




20 4 


CC 


SIIT 


WAIT FOH jilTEHJAL SfliiULI 




P f 




20 b 


CD 


LCOilf 


TA:5II fEB.^Il4lL COIJECT 




? 1 




20b 


Ct, 


^ SCHfSI 


SFECIAL CkEATE TSI 


i FBI? 


P I 




20 7 


C¥ 


COMl 


coMSEcr hm mtt task 


... 


P 1 


^0& 


DO 


DCOi 


MSCOMi^FCt All Kl'T fASK 


... 


P 1 




20^ 


D1 


XTRTK 


EXTRACT TASK TlP^is 


... 


:fp,p f 




2ia 


D2 


SETAE 


SiiT ISYSCBHOiOyS ^/MTRY 




p 1 




211 


D3 


S?ITH 


SEl* I/O DEYICii PAtli 


PEIf 


p 1 




^1^ 


D4 


^ iDSBI 


lAMII HCP Sa3I.E£ft CONTEL 


• «■ a> 


P 1 




213 


D5 


XTESTS 


EXTRACT tHOH IISI 


... 


MP^P 1 




Z14 


m 


SITXTS 


SSl'OP IT3I 


PBIf 


P 1 




215 


1)7 


XflSIS 


EXfRICT FROE SlSlEt TABLE 


... 


M"B,P 1 




21b 


D8 


SEfSlS 


bETOP SYST'SH TAbLE 


£RIY 


P 1 




217 


DSI 


SETTB 


SET EEIL-TIKH I'tlT2RfAL 


pia? 


P 1 




zlH 


DI 


REDTIE 


BKID Tir^ 0? i/IY 


•*• 


iP,P f 




y. 19 


0B 


ITCS 


TAfill I/O REQUEST 


-•- 


P 1 




220 


DC 


••• 


EaS a ODE SHl^ 


... 


P 1 




22 1 


liD 


RESET 


HBSST SOPRESS hSWICE FLlbi 


•■ w • 


F 1 




22.. 


BE 


PORGE 


I'OBGE I/O OFEBITIOM'S 


••• 


P 1 




223 


m 


..« 


SET/lESEf laMEDIITE 
EECORDISG FLAG 


... 


P 1 


f f 

f 1 


2?A 

225 


EO 
^1 


ROPAGE 


1 READ OMLY PAGE OPDATE 
NOT D5FIMED 




P 1 

• • • 1 


226 


£2 


POLS£ 


f POLSE SChEDOLE LEfEL 


• «. • 


^^P^'P j 




227 


tlJ 


CilAMGE 


CdiSGE SCEEDOLE LEfKL 




MF,t 1 


226 


24 


SfSEK 


?i SfSTEM BBS OB j 


PL If 


P 1 
1 
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TNL GN204106 (01 My 80) to GC28-2008-5 



IIIL lEIOEf PlOGRIi SllVICl SfCS 



1 — 

1— 


SfC 
Die 


GOBI 1 

111 1 


HICIO 1 


FUlCTIOl 1 


DCLASS 1 


"1 

CODE f 
RQMT 1 


1 


229 


15 1 


TillT 1 


fllT FOl TBIIIIII. I/O 1 


• • • 1 


1P,P 1 




230 


16 1 


AOXPG 1 


BXTIICT mX PAGE COUITS | 


... 1 


IP rP 1 




231 


17 


lOCIL 


I/O CALL 1 


Pllf 1 


P 1 




232 


18 


... 


IJE LIIE COITIOI, ! 


... i 


P 1 




233 


19 1 


IMDEf 1 


lEIOfB DEflCE FSOl TASK I 


... 1 


P 1 




23 i* 


£A 


IDDlf 


ADD DEf ICE TO TASK 1 


... 


P 1 




235 


SB 


SEtOP 


SETOP TSI 


PEI¥ 


P 1 




236 


IC 


&DSF6 


ADD SHAIED PAGES 1 


FBI? 


P 1 




237 


ED 


DSSEG 


DISCOilECT SHAIBD SEGIEIT 


PBIf 


P 1 




238 


EE 


C1SB6 


COMKECT SHAIED SEGMENT 


PBI? 


P 1 




239 


EF 


EXFID 


EXPAID PAGE 1 


... 


P 1 




240 


fO 


fSSIB 


IlTEl-TASl COIIDIICATIOI 


... 


IPfP 1 




241 


f 1 


CKCLS 


CHECK PIOTECTIOI CLASS 


f ... 


1P,P 1 




2112 


W2 


PSOOT 


1 PAGE ODT 


PBIf 


P 1 




2*3 


P3 


1 fSEID 


1 FOICE TIKE SLICE EID 


f PRIf 


! P 1 




2^11 


F4 


1 SITXP 


! SET EXTEliAL PAGE TABLE 


1 PlI? 


1 P 1 




245 


F5 


lOfXP 


1 lOVE PAGE TABLE EITRIES 


FBI? 


P 1 




246 


F6 


ITlCf 


1 EXTIACT TSI 


[ ... 


t IP^P 1 




247 


F7 


1 QS?C 


! E!IQ/D^Q 


■ • • 


• • • 1 




248 


F8 


Illlf 


WAIT FOE IlTEllOPT 


... 


»P,P 1 




249 


F9 


1 DBLPS 


[ DELETE PAGE 


f PBIf 


f P 1 




250 


FA 


1 ADDPG 


1 ADD PAGE 


1 ... 


I 1P,P 1 




251 


FB 


1 SEfTO 


1 SET OSEl TliBl 


; PBIf 


1 P 1 




252 


FC 


1 DLTSI 


f DELETE TSI 


1 PBIf 


1 P 1 




253 


FD 


1 CITS I 


1 CIEATE TSI 


f PRIf 


1 P 1 




254 


Fl 


1 EllOS 


1 IH Sf STEM IBIOI 


i ... 


1 ... 1 




254 


Fl 


1 LfPSi 


f LOAD fllTDAL PSl 


f PBIf 


f P 1 




255 


FF 


1 ... 


1 lOT DEFIIID 


1 


1 ... 1 
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*F1-\FMD II C: TSS EXTSIDED PIOGBIM IlTllBUPTIOl CODES 



'I'h« resident supervisor amst pass back to tlie virtual storage error 
processors a code identifying the tfpe of software error detected bf the 
^iipenisor- To accomplish this^ the Superwisor Processor ii,.iist put a GQl 
i-r. the appropriate task's TSI prograii iatermptioii gmeue of the task in 
?r'''-!3r. The iEtermptlom code in the GQE coHtaiB,s a, valae that identi- 
ji^-^r-: the cause of the prograa iaterrttption- 

HeyadeciBal codes 01 through 13^ ^0 , and 80 are used bf the hardware. 
:odes 1'4 through 1F are reserwed for hardware. The remaining codes 
„hro'.?gh PFFF {including 00| are used for specif fiig software program ia- 
.. ,.,. .^ .^^ X J p I: i o a errors* 

:'^.e dc^fiiiei codes are shown in Figure ^0. 



CODE f 



SfTI 
CODE 



00 



G i - I ? i 



I 3 

i 

I 3 

i 
i 

) 3 



2.1* 



2S 




3 


26 




3 


? ? 






28 






29 






2P\ 






2B 






?C 






;>D 






2E 




3 


'} ft' 




3 


30 




3 


J 1 




3 


Z'i 


a 


3 


iTOX'lv 


tlO. 





MODULE 



CE&AO 
CEII1 

CEIIO 

CEII1 

CEI&l 
CEilO 



CEIIP 

CEIIF 

CEIIF 

CEIIP 

CEIIF 

CHIP 

CEIIP 

CEIAO 

C1II1 

CEIIO 
CEII1 

CEIl**" 

CEIIO 
CEII1 



ERIOI DESCBIFTIOI 



lOT DEFIllD 

SPECIFIED II »P1I1CIPLES OF OPEBITIOl* 

lOT DEFIIED 

PIGB LIST LEIGTH TOO LOIG 
PIGE LIST LEIGTH TOO LOIG 

101-ElISTEllT BOPPEB PIGE 
lOl-EXISTBlT BOFFEE PIGS 

TISl HIS 10 DEflCES ISSIGllD 
TISIC BIS 10 DEVICES I5SIG1ED 

lOlCB LElGffi EQOILS ZEIO 

lOT DSPIIED 

COOITER OfEBFLOM FOR PHOGRIff IITEEIOPTS 

COUIfEl 0¥ERPLOi FOR SfC IlTEBllPTS 

COUITEB OfBBPLOW FOB EXTEBWIL IITBBUJPTS 

COUITER OfEHFIOi FOR IfTESTIOf IlTEllOPTS 

COOITBE OtESFLOi FOB TIBER IITEIIIPTS 

COUITEB OfBlPLOi FOB I/O liTIBSlIPTS 

OICLISSIFIED TISK IITEEllIFT 

lOlCB LEIGTH GBEITIR Tffll ^0 96 BITES 

lOlCB ClOSSES PIGE BOUIDiRf 

DEflCE lOT ISSIGISD TO TISK 
DEVICE iOT ISSIGllD TO tISR 

DILITB PIGE OF WIOIG CLISS 

10'1-lXISTEIT SVC PIGl 
WOI-EXISTEIT SfC PIG.E 
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h a 



r 1 
1 PI 
1 CODE 


"1 
SVTY 
CODE i 


HODOLE 


— ■ -1 

EllOl DESCIIPTIOII 1 


f 33 


3 


CE1I1 


SIC PAGE lOT 11 MAIN STORAGE | 


1 34 


3 1 


CEIIO 
CEAA1 


CCi LIST OUTSIDE OF SfC PAGE | 
PGOOT REQUEST MIXES SHAIBD AHD PRIVATE | 


1 35 


3 


CEAHD 


DELETE PAGE 11 Ul-ASSIGMED SBGMEIT | 


1 36 


3 


CEIID 


DELETE Ul-ASSIGIED PAGE I 


I 37 


3 


CEAHD 


IHVALID IMPUT PARAMETERS TO DELETE PAGE | 


1 38 


3 


CEAND 


IMVALID lAMGE FOR SHARED DELETE | 


1 39 


3 


CEAH7 


ATTEMPT TO RE-ASSIGl AM I?H PAGE f 


1 3A 


3 


CEAB7 


PAGE lOT 11 CALLER'S PAGE TABLE | 


1 3B-3C 


3 


- 


lOT DEFIIED 1 


1 3D 


' 3 


CEJIQ6 


t THE SHARED SEGHEIT TABLE OfERFLOWED | 


1 3E~3F 


' 3 


- 


MOT DEFIIED f 


1 40 


- 


- 


MOIITOR CALL HARDWARE IITEIROPT | 


1 41-47 


' 3 


- 


MOT DEFIIED | 


1 48 


3 


CEAH2 


IIVALID IIPDT PARAMETER TO SETOP/XTRCT | 


f ^9 


3 


CEAP7 


AWAIT SfC NOT BXECDTBD REHOTELI OR ELSE lOT | 
OH THE LAST HALFWORD OF AH ECB I 


1 4A 


3 


CEtQ7 


1 IHVALID IHPUT PARAMETERS TO COllECT | 


1 4B 


1 1 


CEIQ5 


1 ?SEHD SfC HOT EXECUTED REMOTELY | 


1 4C 


i 3 


CEAQ5 


1 fSElD MCB EXCEEDS 1912 BYTES OR CROSSES f 
1 PAGE BODIDARY | 


I 4D-4F 


' 3 


- 


[ HOT DEFIIED f 


1 50 


1 3 


I CEAHQ 
CEAR3 


1 TASK HOT OF SIFPICIEHT PRIVILEGE TO ISSUE | 

f SfC f 

TASK HOT OF SUFFICIBHT PRIVILEGE TO ISSUE | 

SVC f 


1 51 


3 


1 CE1H7 


SETXP SfC HOT OH FULLHORD BOUHDARY | 


I 52 


1 3 


1 CE1H7 
CEHDB 
CEHDE 


( COUHT OF EXTERHAL ADDRESSES IS ZERO | 

1 IHfALID flA PASSED TO fSS GET REAL PAGE | 

IHf ALID TYPE REQUESTED FOR fSS EXIT f 


1 53 


1 3 


CBAH7 


PARAMETER LIST CROSSES PAGE BOUHDARY OR | 
[ PAGE HOT IH CALLER'S PAGE TABLE | 


1 54 


1 3 


CEAH7 


1 COUHT OF EXTERHAL ADDRESSES EXCEEDS 1022 | 


1 55 


' 3 


CEIH7 


( A SPECIFIED PAGE IS UH-ASSISHED f 


1 56 


= 3 


CEAH7 


1 EXTERHAL DEVICE ERROR f 



Figure 40. TSS ExteBded Prograa Interrupt Codes (2 of 5) 



Appendix C: TSS Extended Prograa Interruption Codes 269 



r 1 

1 PI 
1 CODE 


S?TI 
1 CODE 


r 1 

MODOLB 


i ^ 1 

1 ERHOl DESCBIPTIOH | 


1 57 


3 


- 


I MOT DEFIHED | 


1 58 


3 


CEIQ8 


IHVALID MPPT PAHAMBTEl TO DXSCOllTECT | 


1 59 


3 


CEAME 


IIVALID IMPPT PAIAHETER TO ADD PAGE | 


f 5h 


3 


CEAQ7 


ATTEMPT TO COIIBCT TO M-ASSIGMED PAGE | 


1 5B 


3 


CEAKl 
CEAPO 


ATTEMPT TO CAICBL MOI-BXISTEHT TIHEl | 
ATTEMPT TO HOVE FHOH HS-ASSIGHED PAGE | 


1 5C 


3 


CEAPO 


ATTEMPT TO MOfE TO TO-ASSIGIBD PAGE f 


1 5D 


3 


CEAS2 


ISFALID IIPOT PAIAHETER TO SETSYS/XTRSTS | 


f 5E 


3 


CEAS4 


I1?AI.ID I1P0T PARAMETER TO SBTXTS/XTRXTS | 


1 5F 


3 


CEAPO 


MO?B FROM OR TO SHARED PAGE | 


1 60 


3 


CEAIE 
CZCJ1? 


ADD PAGE REQOEST lOT SATIS IFIED f 
EHTER S?C ISSUED WHILE 11 TYPE III LIHKAGE | 


1 61 


3 


CZCJT 


ERTER S?C ISSUED WITH IRTALID ERTER CODE | 


1 62 


3 


f CZCJT 


S?C ISSUED II ROI-PRIflLEGED STATE ARD 10 | 
IHTBERUPTIOl ROUTIME SPECIFIED | 


f 63 


3 


CZCJT 


HO ERROR ROUTIWE DEFIRED FOR DEVICE fITH | 
ERROR 1 


f 64 


3 


CZCJT 


ASYICHROROUS IITERRUPT RECEIfED BUT MO DE | 
AVAILABLE FOR DEVICE | 


1 65 


3 


CZCJT 


SETTR MOT ACCEPTED BECAUSE SYSTEM LIMIT | 


1 66 


3 


CZCJT 


SVC IITERRUPT RECEIVED IHILB II TYPE III | 
LIMKAGE I 


f 67 


3 


CZCJT 


PROGRAM IITERRUPT RECEIVED IHILE II TYPE III | 
LIMKAGE I 


1 68 


3 


CEAQ2 


ATTEMPT TO SET TIMER BEYOND 55,3621,812 f 
HILLI-SECOMDS I 


1 69 


3 


CEAAC 


IMVALID SDA DETECTED II ADD DEVICE | 


1 6A 1 


3 


CEAAK 
CEAPO 


IIPUT SDA OUT OF RAMGE | 
IMVALID IMPUT PARAMETERS TO MOVE PAGE | 


( 6B 1 


3 ! 


CEAQ4 


IMVALID IMPUT PARAMETERS TO CHECK CLASS | 


1 6C i 


3 


CEAA1 


PAGE OUT REQUEST FOR ZERO PAGES | 


1 6I> 1 


3 


CEAQ6 


IMVALID IMPUT PARAMETERS TO ADD SHARED PAGE ) 


1 6B-6F 1 


3 ! 


1 


MOT DEFIMED | 


1 70 


3 


CEAAK 


A SETAB WAS ISSUED TO DEVICE MOT ASSIGMED r 
TO TASK 1 


1 71 


3 


CEAAK 


A SETAE WAS ISSUED SPECIFYIMG A MOM-BXISTEIT| 
TASK * i 
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I i 

1 FI 1 
1 CODS 


S?TY 1 

CODS 1 
1 


HODULE 1 


r — — "- - — -■ "■■ -- ■ — —•— -" - — - -■' -"- ""■ — 1 

SBEOl DESCEIPTION | 


1 72 


3 


CEAPl 


IMflLID INPOT PIRAMEIEES TO EXPAND PAGE | 


f 73 


3 


ClAFl 


TASK EXCEEDED EkXimm PAGE fABLE PAGES | 


1 74-78 


3 i 


i 


MOf DEFINED | 


1 79 


3 1 


ClAHQ 1 


IM¥ALID SVC CODE | 


1 7I-7B 


3 


-. 


MOT DEFIIED | 


I 7C 


3 ! 


ClAIO 


lOCIL SfC CCl LIST CAlHOf BE EELOCITED | 


1 7B 


I 1 


CBAAO 


DlAi CC« LISf CISlOf BE BELOCITED | 


1 7E-7f 


3 


- 


»OT DEFIIED 1 


1 80 


; 


- 


PKOGEia EfElf EECOIDIIG HABDIAF.E li-TBllOPT | 


1 81-8F 


3 


~ 


lot DEFIMED 1 


1 90 


2 


■ CBIAQ 


HELOCATIOJSf lEID: 10 PIfH AfAILIBLE | 


I 91 


2 


CEAIQ 


RELOCATIOI? lEAD: I/O E&BOl OM PEEMllEIT | 
VOLUME 1 


1 92 


2 


CEIAQ 


RELOCATIOI READ: I/O EBlOl 01 HOfEIBLE | 
' VOLOHE 1 


1 93 


3 


CBAAg 


BBLOCATIOl READ: SUIFICE EBBOR | 


1 m 


1 2 


i ClAAQ 


! lELOCATIOi BEAD: START I/O FA HOSE | 


I 95 


i 2 


CEIAQ 


i SlPESflSOI PAGIIS BEQUEST: SO PATH IfAILABLEf 


1 96 


1 2 


^ CEAAQ 


SUPEEflSOF PAGIIG IIQOIST: I/O ERIOR 01 | 
I PEEHAIEMT VOLOIE | 


1 97 


2 


I CBAIQ 


' SWPEMVISOE FAGIIG BEQUESf : I/O EBBOR Oi | 
' HOVEABLE VOLUME | 


1 98 


3 


1 CEIAQ 


' SUFBlflSOB PAGIIG BEQUEST: SOBFACE BBlOl | 


1 99 


f 3 


1 CEIAQ 


f SOPERflSOl FAGIIG IIQOEST: START I/t) FIILDEEf 


1 91-9E 


3 


f 


1 iOT DBFI»EI) 1 


1 9F 


2 


( CEIIQ 


! TIIIT HAD: 10 PAT3 AfAILABLE | 


1 AO 


2 


1 CEIIQ 


! TIAIT BEAD: I/O EllOl 01 PEEIIAMEIt fOLOHB | 


1 A1 

1 


2 


1 CEIIQ 


[ TIAIT HEAD: I/O EBlOl 01 lOfEABLE fOLOBE | 


1 

1 A2 


2 


1 CEIIQ 


1 TIAIT EEAD: SllFACE EEROB | 


1 A3 


2 


I CEIIQ 


1 TWAIT ISID: START I/O FAILURE | 


1 A4-1F 

1 


3 


- 


\ iOT DEFIMED f 


1 

1 BO 
1 

1 

1 

t 


3 


1 CEIP2 
[ C1IF4 
1 C1IF5 
\ CBIF8 

1 CBIQO 


1 SVC iOT EXECOTED SEHOTELY f 
1 SVC iOT EXECOTBD lEROTELI | 
1 SVC IOT EXECOTBD REIOTBLI | 
I SYC IOT EXECOTED BEMOTBLI I 

f SVC IOT EXECUTED lElOTELI f 
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I 



PI 

CODE 



S2 



B3 
CO 

C7 I 
I 

C8 I 
I 

C9 I 

CA I 
CB-CF I 



DO 

Bl 
111 
L3 
Dii 
US 

1)7 
1)8 

m 

DA 
DB 
DC 
DD 

DF 

i.O 

El 

S2 

I 

e:> i 
f 

i 

FO-FF I 



_ — --_«^^ „^„-_-, 

CODE I MODfllB 

I 

3 I CE&P2 

I CIIPII 

f CEIP5 

f CEiF8 

I CEIQO 
i 

C£iF2 

CE1P5 
C1IP3 
CEAaO 

CE&QO 

CZCJT 

CMABI 

CEIHQ 

CESEH 

CEITB 
CEATB 
CSATB 
CEiTB 

ClITB 
CSITB 
CEITB 
CEATB 
CliiTD 
CEATB 
CEATD 

CEITD 

CEIfD 

CEAT0 

CBITD 

CEITD 

CEDKOI 

CEATB 



I 3 

I 

I 3 

f 

I 3 

I 

I J 

I 

I 3 

f 

I 3 

I 

I 3 

I 

t 3 

I 

I 3 

I 

I 3 

I 

I 3 

I 

I 3 



EEEOR DESCHIPTIOl 



SfC SOT Oi FOLLiOlB BOOlBIEl 

SfC WOT OM FOLLiOBD BOOID&EI 

SVC MOT OH FIIILiORD B0O1DIHT 

SfC MOT 01 FOLLMOBD BOOIDIRI 

SfC WOT Oa FlILLWOBD 30010111 

FifilEETER LISf CfiOSSBS PAGE BOraBIEI 
PAEAHETBB LIST CBOSSBS PIGS BOUlDIBf 
BIHIHITES LIST CMOSSES PAGE BO0IDIH1 
PIR&llTEE LIST CBOSSES PIGE BOUIDIKI 
FIEA?!ETER LIST CF.0SS2S P&G5 BOUlDlEf 

Ilf&LID GET/TOT SSffED SEGfEST IIDIC&TOB 

NOT DEFINED 

ISA DE5TP0YED 

NOT DEFINED 

UiCOllECTED fiACHIlE CHECK DUEISG flSK 

fISK HAS EXCEEDED -IT»S TSEJD SfC EtXIKOE 

lOT 0KBISEB 

ElJOg fISTUil. ^ErOfil SISER 

SOT DKFIiED 

SfC JOT REtQTELl ElfcCOTED 

Ii^fAiiD Bli OB 10 TERMIEAI COIlECfED TO TASK 

IlfALIB PEQUESt CODE 

fiLIl) SLl BUT MO TCT ISD REQUEST lOT FREE 

IlfALIB FLAGS II TCLE&B HEQ02ST 

ISflllD EEID LEIGIH 

IJflLID iHITii LEHGIE 

ISfALID DITA ADDSESS FOB lifilTl 

SfC lOT KEMOTSLI EIECOTED 

IlflLID SIM li firSfC EEQCEST 

liflLID REQOiST CODS IH TMSfC BFQUESf 

2SB0 PIG? COUKT Ik- SAfBFP KEOUBSf 

ISfiLID fKI li S^fBF? feEQOESl- 

ZEHO PAGE COOIIT Lli RS'lBf^ REQUEST 

IP?&LrD fK& IW RStBFP REQUEST 

ESTBFP BOFFEIC PIGES liCOERECTLI FOREATfEB 

RSTBfP SOPFEK COMTAIMS IlfALID D1T& 

IH¥ALID fMA II SlTTCt REQOEST 

I^fMID I/O REQUEST ISSOED Bf TIBII 

RORE THIS 24S REQUESTS OOEOEB 01 TEIHIM^L 

RSSBKfSD FOB TAail 

HOT BEFIiED 
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APPEIPII Ds PYHAKIC I.QADEB 



Everf task has a task dictionarf (fDl) , vkick contains, in addition 
to the progran Module dicrtionaries (PlBs) , the hash tables used by the 
dfnanic loader to process external definitions (BSFs) and external ref- 
erences (BSFs) • The hash table is split into three parts: privileged 
system, nonprivileged system, and nser symbols (see Figure 41) • then 
the loader encounters a lEF in a control section with the attribute of 
PRTIGB, it searches the privileged systea hash table; if the attribute 
of the control section is nonprivileged SYSTEM, the nonprivileged system 
hash table is searched; if the attribute of the control section indi- 
cates that it is a user's, then the nser hash table is searched. One 
exception to this rule occurs when a user's authority code is F or O. 
In this case, the loader ignores the user hash table and searches the 
two system tables. Figure 42 summarizes the actions of the loader in 
processing the BSFs and BEFs* 

notice that the loader erases the attributes of PUBIIC and lEIDOlLY 
from any module loaded from any library for a programmer with authority 
code 0. The attributes PUBLIC, BBABOlLf, SISTBB, and FB¥I.GB are erased 
from any mMule loaded from JOBLIB or USEBIIB for a programmer with au- 
thority code F. If a programmer with authority code F loads a module 
from S7SLIB, only the FOBIIC and BEABOILT attributes are erased* 

Bemember, though, that the loader does not load initial virtual 
storage (IVl) • fo^ will always get a public, read/write protected copy 
of ITO. The loader's action in assigning storage keys to control sec- 
tions is governed by the attributes of those seirtions. (See Figure 42 
and Figure 43.) 









r 


LIMK TO FIB ST FIB SBOBF 


i 






HASH TABLE 


LE1GTH/BI¥IS0B (L) 








ABBBESS OF 


SYSTEM HASH TABLE 






1 

I 

1 










ABBBESS OF 


USEE HASH TABLE 




r 


SISTEI 

HASH 
TABIE 

USEB 
HASH 
TABLE 




>l 








FBIVILEGEB SISTEI HASH TABLE 
(PREFIXES CZ AlB CHB) 




■ 




101FBI¥ILEGEB SYSTEM HASH TABLE 
(FBEFIXES OTHBB THAI CZ OB CHBJ 








ALL BSEB SYHBOLS 





Figure 41. Bynamic loader three-part hash table 
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Bjnaaic Loader Sjubol Lookup Rules 



if 



I 



and 



and 



1 

authority I loader is 
class is: I resolving 

jsfBbol from: 

I 



and 



then 



or 



high -order bit of | control section con- 
C1 or C3 byte of jtaining adcon group 
adcon group is: |or lEF is: 
I 



lookup 
symbols in 
hash table; 



If symbol is 
not in hash 
table search 
library: 



-I 

I Explicit 

ILO&D/CALL or 

I DELETE adcon 

I group 

I 

I 



I 



H 

I SYSTEM 



STSHISHP or 
SISHASHIP 



STSLIB 



I 

flOlSISTEH 



USEHHISH*** 



ALL** 



4 

IHOMSISTEi 
I 



SISHJISHP or 
STSIISHIP 



STSLIB 



I 

I External BEF 
I 



I STSTEH 



nSBlHISH*** 



ILL** 



JSYSTEl 
I 



STSHISHP or 
STSHISHHP 



STSLIB 



HA* 



I 

IHOHSTSTEH 
-i 



PSEIHISH*** 



ILL** 



P or o \ 

f 



HI* 



HA* 



HI* 



STSHISHP or 
STSHISHHP 



ILL** 



Symbol Posting Bules 



if 



and 



then 



and if 



then 



and 



authority 

class is: 



control sec- 
tion that 
contains DEP 
case from: 



I control section 
i attributes may 
I be altered: 
I 



control section thatJDEFs may 
cron tains DEF has j begin with 
attributes: jonly the 

t symbols : 

I 



-f- 



(all legal 
(symbols from 
I control sec- 
jtion are 
(posted in: 



(If control sec:- 
Ition is PEVLGD, 
(LOADEH SETS 

(STSTEH attribute; 
STSLIB (hence, HOHSTSTEH 
(and PE?LGD is 
I impossible 
I 



STSTEH 



PITLGD 



fCZ, CHB 



(STSHISHP 

-I 



liny but CZ, (STSHISHHP 
HOHPITLGD (CHB ( 

( 



I 

(CZ, CHB 



HOHSTSTEH 



(STSHISHP 

-( 



( 



STSULIB or 
JOBLIB 



(PITLGD and 
(STSTEH erased. 



HI* 



-4Iny but STS(USESHISH 
( I 



STSLIB 



PUBLIC p lEID-OHLT 
erased . 



liny 



ISTSHISHHP or 
(STSHISHP 



HI* 



STSOLIB or 
JOBLIB 



(PUBLIC, REID-OHLT 

(PR?LGD, 

(STSTEH erased. 



I Any but 
|CZ, CHB 



H 

ISTSHISHHP 

I 

» 

H 



HI* 



PUBLIC, BEID-OHLT 
erased. 



HI* 



I lay 



(STSHISHP or 

ISTSHISHHP 
-J 



*HI - not applicable, in the sense that the condition is not tested by the loader. 
**ALL - the entire hierarchy of open libraries beginning at the last defined JOBLIB 
and ending with STSLIB (or with that library yielding a valid definition) . 
***If the symbol to be resolved begins with STS, the loader will look in STSHISHP or 
STSHISHHP, and then in STSLIB. 



Figure 42. Effect of authority code in dfnamic loader processlnrr 
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1 ■ -I'-- ■ 1 T " ■ - 1 

1 III lesQltant SegKeiit | 
1 III AssifQBent | 
1 III Ant Storage Key | 

If*! awe n-F ■!•*?«? 1 C'^Wf^ 'Pvrkfte 1 t— .-.■-.. „ ■ 


1 Object Hodttle | For Hoaules | Ittrllmtes f Pujblic PxrlTate | 
1 II 1 1 


ISTSTBH 1 BEllTllIBLB |CS1CT | C - | 
|P1I¥II.EGBB 1 IISCUTABLE fSlSTlE, F1¥I.6B| | 
1 ICODE IFXLpPUB^EBO | I 

1 1 L.„,_ „_ 1 1 


le.g., ¥11 OFEl IDITI^ IBCOlS^IPSECf 1 - C | 
1 letc. |SYSrPl¥I,GI>^ 1 1 
1 1 IF13- 1 1 
till 1 


IS7STEH FEICE IllElTEBABLE ICSEC7 |BCPSE1 BEAD | 
ISITTEl lEXBCOTIBLE | SYS, PUB |0II,1) - | 
1 ICOBE IHDOpFXL | | 

1 1 L... „ 1 i 


|e.g., ¥JIH 6Ef |10BH0BIF1JLBLE|PSECT | - B (USBl BBIB | 
1 IDITI, etc. |S¥S, IBO^FXL | OimTJ | 
till t 


1 SYSTEM I1EE1TEBJIBI.E ICSECT |B(1ISB1 ISIB | 
|S01P1I¥ILBGSB |EISCBfIBI.E | SYS, PUB lOlLY) - | 
1 ICOBE llBOpFXI. 1 1 

1 1 L, , 1 1 


|e.g., ASSEHBLEl |BATI, JIBCOVS , | PSECf § & (USBB BBIB t 

ILPC letc ISYS^FXI, | - ISIfE) | 
till 1 


i f 
|A=Kej 1 B=Key 2 C=i:ef 2 with fetck protection | 



Figure <I3. lelatiomsMp of object Bodules, CSECT, CSBCY attributes, 
sbarability, and storage kef assignseiit 



Ippendix B: Bjnaaic Loader 275 



AFPEMDIX E; ORG&WIZAflQII OF DIRECf ACCISS STQRIGE 



2305 DIOM STOIIGE FOEMIf 

I lach IBM 2305 drma contains 230ft pages of 4096 bytes each. Tracks 

I and 1 contain three IPL records (record #1 and 2 of track 0, and record 

I one of track 1) and the IBM standard voluMe label (track 0^ record 3). 

I Pages through 5 are not available for VIM allocation* 

I DuMMf records of 548 bytes separate each data page to allow data 
channels to fetch and execute channel comnand words between pages. The 
2305 is logically divided into 96 cylinders of 8 tracks each. Each 
track contains three pages and two diiBHiy records. Figure 44 shows the 
organization of a typical 2305 track. 



J J ^ 

{Address { lecord Sizef Page Hiuiber 
Icchhr* I I (slot) 

I ^ — I , 



Icchhl 
|cchh2 
|cchh3 
|cchh4 
|cchh5 
I 



4096 
548 

4096 
548 

4096 



diiB&y record 

2 
dniiiiy record 

3 



!♦ Each tracdc begins with IBM standard 

I record zero, 'cc" is an integer between 

I 00 and 95 inclusive. »hh« is an 

I integer between 00 and 07 inclusive. 



Pignre 44. Organization of an IBM 2305 Drom 



BISK STORJLGE FORMATS 

These restrictions apply to the use of the IBM 2314 or 2311^ when 
formatted in pages: 

1. Cylinder 199 is reserved for standard error-recovery retry. 

2. Page 895 (2311) is not used because of overflow restriction. 

Each IBM 2314 volnse contains 6496 pages of 4096 bytes- Tracks and 
1 cx^ntaln three IPL records (records one and two of track and record 
one of track 1) and the IBM standard volnae label (track 0, record 
three) - Pages to 3 are not available for ?JIM allocation. 

Each 2314 disk pack has 203 cylinders with 20 tracks per cylinder; 
each cylinder contains 32 pages. Figure 45 shows a typical 
or gani za tion • 
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track begins with the IBH standard record zero. 





Fignre 45. Organization of IBM 2314 volnae for ?Jll 

Each IBM 2311 voliiBe contains 1624 pages of 4096 bytes. Tracks and 
1 contain three IPL records (records one and two of track and record 
one of track 1) and the IBM standard ▼olnme label (track 0, record 
three) . Pagess to 3 are not available for ?IH allocation. A 2311 disk 
pack contains 203 cylinders of 10 tracks each; the cylinders are 
organized to contain 8 pages each. Figure 46 shows a typical cylinder 
organization « 
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Figure 4 6. format of IBM 2311 voluae for ?IH 



Each IBH 3330 model 1 contains 23,427 pages of 4096 bytes. Dnumy 
records of 102 bytes separate each page on a track. Tracks and 1 con- 



Ippendix- E: Organization of Mrect I'ccess Storage 277 



tain three IFI. records and the IBK standard Tolnae label. Pages to S 
and 23,423 to 23,126 are not available for TIM allocation* 

Each 3330 sodel 1 disk pack has 111 cjlinders vith 19 tracks per 
cflinder* Bach track contains 3 pages, figure 17 shovs a tjpical track 
layout • 



T 1 

Becord Size| Page limber 
I (slot) 



(Address 
I cchhr* 

I 



1 

1096 I 1 

518 i duMBf recsord 

1096 r 2 

518 I diuiaf record 

1096 I 3 



Icchhl 
|cchh2 
|cchh3 
I cchhl 
|cchh5 
I- 



I* Each track begins with IBH standard 

I record zero. *cc* is an integer betveen 

I 00 and 110 inclnsiTe. 'hh* is an 

I integer between 00 and 18 inclusive. 

I I 

Figure 17. Organization of an IBM 3330 Disk 



Bach IBH 3330 model 11 contains 16,155 pages of 1096 bytes. Pages 
to 6 and 16,151 to 16,151 are not awailable for fJlR allocation. 

The 3330 nodel 11 is identicral to the 3330 model 1 in track capacity 
and tracks per cylinder, lowewer, the 3330 nodel 11 has 815 cylinders 
conpared to 111 for the 3330 model 1. 

Bach IBI 3350 contains 65,100 pages of 1096 bytes. Bnmmy records of 
525 bytes separate each page on a track. Tracks and 1 contain three 
IPI. re€x>rds and the IBH standard Tolnme label. Pages to 7 and 65,395 
to 65,399 are not available for ?1H allocation. Bach IBH 3350 has 560 
cylinders with 30 tracks per cylinder. Bach track contains 1 pages. 
Because of internal system restrictions only 529 cylinders are formatted 
and nsed by TSS. Pignre 18 shows a typical track layout- 
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1 lecord Size| 


Page Inmber | 
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Icchhl 
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1 1 


|cchh2 
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dnmmy record | 


|cchh3 




1096 




2 1 


Icchhl 




525 




dummy record | 


fcchh5 




1096 




3 1 


|cchh6 




525 




dummy record t 


|cchh7 
■ 


t 


1096 


^ 


1 t 
■ 


i 

1* Bach track 


begins 


with IBH standard | 


1 record 


zero 


. »cc« 


is an integer between | 


1 00 and 


528 


inclnsive . 


•hh> is an | 


1 integer between 00 

L » - -.., 


and 


29 inclusive. | 



Figure 18. Organization of an IBH 3350 Disk 
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APPKMDIX F; BTAM LOG EMTBY DEFIHITIOHS 



All B!EAHLOG entries are 32 bytes in length. The first 16 bytes are a 
coBBon header which contains the Bodole and entry IDs, the SDA or RID of 
the device, and 8 bytes of coBBon inforBation. The second 16 bytes are 
entry dependent. 

Module IDs are set ap as follows: 

X*00* - RTAH services entry 

X«01» - CEDH01 

X«02» - CEDH02 

I»03» - CEDH03 

X'Oft* - CEDH04 

I»07" - CBDH07 

X»08» - CBDHOB 

X«09« - CEDH09 

X«OA» - CEDSSCP 

X«OB« - CEDHOB 

X«OC» - CED37XX 

X«OD« - CBDLUCP 

X»0D11* to X«0D16« - CED327R 

X»37« - CBDBH 

The 8 bytes of coBBon inforsation are arranged as follows: 

the first 4 bytes are coBBon to all entries; 

the second 4 bytes are dependent on the control type which is de- 
terBined by the TCTLO bit in the TCT; if this bit is a zero the 
control type is called an ■I/O control type*, zmd if the bit is a 1 
the control type is called a "logical unit type*. 

The f ornat of the BTARLOG entries are as shown below: 



COHHOV BEADEB (16 BTTES) 



I EiTBT I 
I DEPEIDEBT | 
I I 



I 1 I 1 I 



I 



I 



I 16 BYTES 



I 



i 1 SDA 


TCT PLAG 


1 1 or 


COHTEMTS 


1 1 BID 


TCTSTS1 




TCTSTS2 




TCTSTS3 


1 BBTBT ID 


TCTBCT 


HODDLE ID 





21R0BS 
CQIT&QI, TYPE 
I/O COITEOL: TCTIOFI TCTI0f2 SCIFB2 SClSTIf 

IsQGlCM. 01 ITS TCtSTII TCfStJI2 TCflOSi fCfI0S2 
(TCTiU^I) 
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IPPEMBIX G: PSBB LIMITS TABLE 



ihien a user is joined to the sfstes, lie is assigned a set of limits 
vkich determine maxisaB amounts of sjstem resources he maj use. Which set 
he is assigned is specified in the RlTIOl operand of the JOIl command. 
Two sets of limits (vhose values are listed in the fignrai below) are supp- 
lied with the system; the first set {Icef 1) represents limits for the sys- 
tem programmer^ the second set Cfeey 2) represents limits for the privilege 
class D user. The installation may modify these values or add additional 
sets. The table containing these sets is called the user limits table; 
each set of limits is an entry in the table. &n entry represents a record 
in SfSOLT, a fISlI member of the ¥PI1 data set STSLIB. The layout of an 
entry in the user limits table is defined in the DSICT CHIOLT. 

The pre-joined users named TSS, STSlllGS^ and SYSOPEIO^ are given a set 
of limits independent of the user limits table. These values are also 

shown in Figure 51 . 



1 ■ ■ ■■ " ' ■ ~"- 1 ■""■ ■■■"! ■ " - f ™-.^.,„. _ . -«^ 

1 1 1 1 1 TSS, 3| 
1 1 t 1 1 S1SHA16B, 1 
1 Item 1 Set 1 | Set 2 | Set... | SYSOPIBO | 

1 til • 1 


1 Limits Category (Key) | 1 | 2 | | - | 
ICPO Time III 1 1 
1 (milliseconds) | 2^000, 000 » 12,000,000* | Installation |X«7FFFFFFF«*| 
IConnect Time (seconds) |2, 000 ,000^12, 000, OOO^fmay modify |X»7FFFFFFF»«| 
ITask Count | 200 f 20 I Sets 1 and 2| 200 «| 
llux. Storage Pages | 2,000 | 500 |or add up to| HOO | 
ITemporary Public Pages| 20,000 | 2,000 |7 more sets | 20,000 | 
1 Permanent Public Pages! 20,000 | 1,000 | (7 acre | 20,000 | 
1 Direct Access Devices | 20 | 1 (entries in | 20 | 
1 Magnetic Tape Drives | 20 | 1 lUser Limits | 20 | 
High-Speed Printers | 20 | | Table) . | 20 | 
1 High-Speed III I 1 
1 Headers/Punches | 20 | | | 20 | 
1 ■ t • ■ 1 


1 12,000,000ms = hrs:33min:20sec. | 
1^2,000,000 sees = 555 hrs:33min:20sec. | 
1 ^Independent of User Limits Table; shown for comparison. I 
|*X»7FFFFFFF« ms = 1,118 hrs:28min:51secs. | 
|«X»7FFFFFFF» sees = 1,118,481 hrs:03mins:59secs. I 
f«^400 FOl OSll WIMED TSS. | 



Figure 51. System -supplied values for user liaits table 
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APPEMDIX H; glCILIflBS BY gllVILBGE CLASS AMD AOfHOBITY CQDB 



ladividuals assigned particular privilege classes and amthority codes 
aaj eaploj facilities available o&lj to their class or code, h siuiKarj 
of tke facilities associated with each class or code follows. 

Privilege Class A - Systea Operator 
ASIBD, BCST^ CAICBL, DROP, FOICB, HOLD, BSG, PEIIT , RBPLT, IT, SHUl- 
DOQH, and 0SA6B coaaand options indicated in Operator's guide ; all 
conaands in Coaaand Svstea Oser's Gnide (not regniring additional 
privilege) . 

Privilege Class B ~ Svstea Adainistrator 
Saae as class F except that tke privilege class B user can Join user 
IDs of onlj one-to-six characters, prefixed by the systea with first 
two characters of adainistrator *s ID, and he can only assign D privi- 
lege classes* 

Privilege Class D - Pser 
All coaaands in Conaand Svstea User's goide requiring no further privi- 
lege or authority (for exaaple, 0PDTOSB1 reguires an authority 
code) . 

Privilege Class E - Systea Monitor 
I Use of HSAN and TAHII aacro instructions; additional BSAH and QSAH 

options; On Line Test Systea (OLTS) facilities; Virtual Heaory Error 
Recording Procedures (flBREPI ; and ability to refer to devices 
syabol icalLly . 

Privilege Class F - Svstea Kanager 

CAMCBL, JOIN (full eight-character user IDs and all privilege 
classes except A and F> , LOgOV, LOGOFF, DSS?, LIMB?, and QUIT coa- 
aand options indicated in Manager's and Adainistrator's Guide ; all 
coaaands in Coaaand Svstea User's Guide (not requiring specific au- 
thority or privilege codes) ; all coaaand facility options available 
to B class user. 

I Privilege Class G - Special 

j Can DDSF restricted DASD irilTS. 

I Privilege Class T - HTT Adainistrator 
f Can create an MTT task. 

Authority Ct^de P - Pser 

1. Cannot invoke Tiae Sharing Support Systea (TSSS) , but can use it if 
connected by a aaster systea prograaaer. 

2 . PCS Osmge 

• Can use PCS to display (using absolute virtual addresses) non- 
priv:Lleged systea routines residing in virtual storage. 

• Can iise the PCS DISPLAY and SET (using syabolic labels) coaaands 
in his own public or private nonprivileged virtual CSBCTs and can 
use AT in private nonprivileged virtual CSECTS. 

• Cannot use PCS to display privileged CSBCTs, public systea 
CSBCTs, or to display (syabolically) areas of nonprivileged sys- 
tea CSBCTs, because systea syabols will not be resolved. 

3. Can code and asseable or ooapile nonprivileged or privileged code 
(obtaining privileged aacro expansions by use of the DCLASS aacro 
ins*truction) , but cannot load or execute any privileged code fas 
privilisged) froa his PSBILIB or Job libraries because of dynaaic 
loader protection. P authorization prograaaers who asseable privi- 
leged CSBCTs aust have O authorization prograaaers load and execute 
that code as privileged-. 
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lote: The dynamic loader erases tke PlfLGD aad SYSTIM attrilmtes 
to prevent U aiitliorization progranners froa changing privileged 
system code. U authorization programiiers can run privileged system 
code as nonprivileged by creating their own IVl symbols and over- 
laying special SVC instructions. 

i|. Could have O authorization programmer pnt a privileged CSECT he had 
created into SfSLlB and could then execute that code (depending on 
whether that code refers to system data sets) • 

5. Can execute any privileged code in SYSLIB from nonprivileged code 
only indirectly by establishing the proper linkage. 

Authority Code P - Monprivileaed System pt^oarammer 

1. Can use TSSS as a master system programmer (ISP) or as a task sys- 
tem programmer (TSP) if residing at the terminal. 

2 • WCS Usage 

• Can use PCS to DISPLIf from public or privileged CSlCl^s; cannot 
SIT or Af in public or privileged code. 

• Can use PCS to DISPLAY fsymbolically) , SBf, or IT into private 
nonprivileged system code as veil as into his own nonprivileged 
routines (loaded from his OSBILIB and JOBLIBsJ that reside in 
virtual storage. 

• Because the dynamic loader strips the PBIVILIGID attribute from 
privileged system modules when they are loaded for a P authoriza- 
tion programmer (from USBRI.IB or JOBLIB) , the private copy he re- 
ceives is nonprivileged, and he can debug and alter that copy. 

3. Can assemble or compile nonprivileged or privileged code (obtaining 
privileged macro expansions by use of the BCIUSS macro instruction) 
but cannot load this privileged code (as privileged) from his USBl- 
LIB or JOBl IB because of dynamic loader protection. Therefore he 
will not be able to execute privileged code (as privileged) from 
those libraries. 

4. He can execute any privileged code in SYSLIB from nonprivileged 
code by dynamically loading the code and establishing appropriate 
linkage. 

Inthoritv Code - Privileged System Programmer 

1. Can use TSSS as an MSP or TSP if using the proper terminal. 

2. PCS Usage 

• Can use PCS to DISPLIf or SET in public or privileged system 
code. 

• Can use PCS to BISPI.IT, IT, or SIT in nonprivileged virtual 
storage. 

3. Can code nonprivileged or privileged code (in conjunction with 
BCLISS) to go into BSIRLIB, STSLIB, or a job library and can 
execute privileged code from any of these libraries. He can also 
execute any privileged code or write into any privileged code. 

#. Has exclusive right to the LfPSl macro instruction (Sf C) . 

5» He alone can execmte privileged code. 

6. Can DISPLII, SIT, or BHHP from I¥H. 

7. Use of Cff , OPDTHSBR facilities. 

8. Can open privileged system data sets. 
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IFFEIDIX I: DBBPGglBG IIDS FOB CQHMOM SYSfEH PBOBLEHS 



i^"""^*^"--....^ pioBLEi i sTsiii* i r i i i 


ilXIlIIE ^"^""^^--.^.^^^^isilIEBTISOl OSll TISKIFIILSilz JsilTEa f LOOPS ♦) COllllTS | 


ICIIJII. 1 XI X IX 1 X 1 X 1 Starts at entrf point CBUIL.| 
ISoperTisor II 1 1 1 1 (See Fig- 53) | 
1 Interruption Log I 1 1 1 1 1 1 
■ I'lfii 1 


ICZCJI^L 1 1 X 1 1 1 X (Starts at entry point CZCJTL.I 
flask ionitor II III | (See Fig. 54) | 
f Interruption Log 1 1 1 1 1 1 1 


fClBDII* 1 1 1 X 1 1 1 Points to Page Error Control | 
1 Direct Access II III | Control Block. | 
1 Interface Block 1 1 1 1 1 1 1 


ICHBISA* 1 1 X 1 II 1 Segment 0, Page 0. | 
rinterrnpt II III |X»6C0»=fPSls and regs 13-4. | 
1 Storage Area II III |X«6B8»=old ?PS1 for last | 
1 II 1 1 1 1 task interruption. | 
1 II III |X«7D0»=old progran TPSW. | 
1 II III IX 'SSO ■■'Start of last lOlCB | 
1 II 1 1 1 1 passed back f roa | 
1 II 1 1 1 1 Supervisor | 
1 1 11 III 1 


1 f 1 1 -f I I i 
ICHBSCI* 1 1 1 X 1 X f 1 Entries for sfsten device | 
IScan arable II III land interruption gnenes. | 
1 1 1 1 1 1 t 1 


fCHBSMC* 1 1 1 X 1 X 1 1 Provides data to Qnene Scan- | 
IScan Easter II III |ner for searcb of Scan Talile.f 


ICHBSXS* 1 1 1 X 1 X 1 1 Contains TSI chain pointers | 
ISfstea Table 11 III land systea parameters. | 


fCHBTSI* 1 1 1 X 1 X 1 1 Contains information used by | 
tTask Status Index | | III {Supervisor for task execution | 


fCEAISl t X 1 XI 1 1 {Contain forward and back- | 
ISTSSSB Save Area 11 III jward links. Contain general | 


fCEEAQB i 1 1 X 1 X 1 1 nodule made a call. | 
f Paging Failure II 1 I 1 1 (See Fig. 55) | 
ISave Area 1 1 1 1 1 1 1 


|*See System Control Blocks for DSECT description, map, and listing. | 

|*A11 SXSBBBs use tke save area in CBAIS. A Supervisor -issued SISEBB may be the result of a| 
1 rm problem, so the STSBBB meaning will determine which type of dump must be taken. If the| 
1 SYSBBB is not listed in current documentation, check the interruption log. If last STC | 
1 254 found with relocate bit in PSW (bit 5) off. Supervisor issued SISEBB. If last SVC 228 | 
1 found with relocate bit on, SISEBB was issued from task. Address in PSl indicates where | 
1 SISEBB was issued. I 
j^The Paging Failure lecovery save area is filled after a solid paging failure has occurred. | 
1 On intermittent paging errors that cause SISEBBs, THBaEPs are useful. Check the Direct | 
1 Access Interface Block (CHBDAI) for a pointer to the Paging Error Control Block (CBBPEC) | 
1 for the failing I/O operation. j 
l^check status of tasks and work known to be in the system: I 
1 Check TSI of current task for 'delay* or »ready» status. GQBs may be queued on task. | 
1 Checdt S€;an Table for active work and suppress conditions. Examine pointers to GQEs gueuedj 
1 on Scan Table. (6Qls may also be gueued on shared External Page Table entries.) | 
1 Check Supervisor Interruption Log for I/O interruptions indicating error conditions. | 
1 (Possiblilities: AIAIT STC issued without preceding lOCAL SVC; relocation interruption | 
f which may have led to page wait condition.) I 
1 ♦Check register D, using roller 1 in position 2. Current PSW is on roller 4, position 1. j 
1 Instruction step CPB to verify loop. If relocate bit (bit 5, current PSl) is on, loop is | 
1 in task. If relocate bit is off, loop is in supervisor. If loop encompasses both | 
1 supervisor and task, instruction stepping may take too long. Find point of transfer | 
1 between supervisor and task by running in normal mode, but stopping on the address of the | 
1 XTSI. 1 



Figure 52. Bat a areas to exanlne for cobboh sfstea probleas 



Ippendlx It Debugging lids £or Cottson Sfstea Problems 283 



CBIJII, 



Header < 



Intries < 



r-" - — 

i Address 


of 


lext ATailable Entry (f SS) | 


1 Iddress 


of 


Start of TSS Log | 


1 Address 


of 


Snd of TSS Log | 


1 Lock Byte | 
1 ' 




Unnsed | 


1 Address 


of 


Vest Available Bntry {TSS} | 


1 Address 


of 


Start of ISS Log r 


1 Address 


of 


2nd of ISS Log | 


1 Lock Byte r 
1 ' 




Unnsed | 

^ . _ _ _ _ M 




|CFU ID |lEt Tjpe 1 Interrupt Code or SDA | 

|See lote 1 |See lote 2 | | 
III 1 


1 Address of 
1 See lote 3 


tSI at Tiae of Interrupt j 


1 est for 


I/C 
foi 


1 Interrupts or J 


1 Old FSW 


: other interrupt typ«5 | 



lord 1 
lord 2 
lord 3 
lord ft 
lord 5 
lord 6 
lord 7 
lord 8 

lord 1 

lord 2 

lords 3^4 



lext Available and Snbsegnent Entries 



I 



lote Is CPU 1 = 80 
CPU 2 = 40 



lote 2: External = 18 
STC = 20 
Program ^ 2B 
I/O « 38 



lote 3: For an I/O Interrupt in Snperrisor state 

lord 2 « Byte 1 of Ext PSl 

Bytes 2~ils Instruction Address 

For BSS Program and I/O interrupts: 

lord 2 » A pointer to TSS LOG where the 
interrupt vonld have been recorded. 

Figure 53 • S nperrisor interruption log 
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CZCJTL 


JLOCAD = Next available entry address 


JLOFAD = First entry cddress 


JLOLAD = Last entry cddress 




(I 





interrupt Tyoe 



OLD VPS'./ ■ 



^ I 



00000001 -Program 
0000000?-" SVC 
00000003- External 
00000004-Asynchronous I/O 
000O0CO5-TImer 
OOOOOCm-Synchronous I/O 



figure 54 . Task aonitor interruption log 



-Contains the length of this sa^e area 



! iORD 1* 



-Contains a pointer to the save area of the CALLIlGf iOHD 2 

program (chain backward) f 

— ^ ., . — ™__™__^__...£.....^ — .4 



-Contains a poiater to the saire area ot the CALLED | ^Okb 3 

program {chain forward) f 
_ — ^^ — ^ ^ ^™™__^^.^ — ___.__^._..„„™^ I 

-Contains the return linkage | WOED 4 

— ^ _-^ _ ^ — _ — __„_„..^_.™^™...^™_^4 

-Contains the entry point address f WORD 5 
^ ™__™ — ^ ^ ___ — ______-.„.._».^^.__4 



-Contain tne co:atents of registers 



12 



I WOKDS 6 - 
_ ._„ ^ ^ ^ — ^ ™ ^ , _^^^.__^^„,™,^_.„.| 

-Contains the address of the CALLING program's | WOPD 19* 

copy of the PSECl for the CALLED prograa i 

_ .^^ ™ . ...—^ ^ „...™.„_.„™^^^„^_„....^^^.^^„ 

♦CALLIHG progra;ii*£ responsibility | 



Figure 5!>* Sa¥e area format 



18 



Appendix I: Debugging Aids for Common Sjsteii ProBlems 285 "^285 



TNL GN20-4106 (01 July 80) to GC28-2008-5 

APPgyPII J: LOGON PROCESSING OVERVIEW 



The changes to LOGOJ for P1PQ2 are basically in the handlina of 
required datasets, especially for SfSOPSRO and pod owners. 
Every attempt is made to complete startup even with back level 
datasets or without certain datasets. This was not designed 
to recover fro» all system problem,s but to give the system 
programmer a chance to fix datasets and then to re-ipl or 
continue. Note that most cases will require a re-ipl. 
Below is an overview of the loaic flow at logon time both for 
initial logon and as a result of abend. This remains the same. 
After the diagrams is a detailed logic flow of the key modules 
in the LOGON process, updated for the new catalog structure , 
for this new LOGON code and for all other PRPQ2 and Dre-PRPQ2 
functions.. In addition^ attached is a nodule-by-module 
description of what happens at each ©articular dataset 
failure and the attemoted recovery procedures- 



Overview of the LOGON Process 



CZFTB (Interrupt Handler) 










QLEs to 

f 












f 
CZIHE (Initial 
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Interrupt Handler) 


I 
CZAAF (firtual 
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Memory 


Task 


Initiation) 




f 
C2ATD (Virtual 

1 1 


Memory 


Task 


Initiation 


II) 


1 f 
C2AFK C2BTB 












(Logon) (Logon2) 













AFTFl AN ABEND 
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:ZkCl ihBESD) 



1 


1 


r 


CZAHB1 
1 


CZITD2 
f 1 


CZC JOS 


CZAIF1 
1 


f 1 
f 1 





CZITD1 CZAFF2 CZAF^4 

Functions of Modules in the. LOGQM Proces s 

CZIHBI 

Wark task conversational flSACOf^TCKCOV) 

ITRCT userid and lofe to TCHOID 

XTKCT taskid 

If not taskid 1 turn off operator flag fTCMOP) 

Ose taskid to search pool table (Call CZCBA1) 

If userid not usable (OIDBS?pOIDMO?I ^UIDMOfS) or delete 

pool in progress^ (APIDEL) , do TFREE and DLTSI 
If the pool is in maintenance, allow only pre joined 

user on (APIUSB) and set up as maintenance taskid (IPirTID) 
Setup poolid (TCMPI0) 

Set up P¥T pointer in TCMPVT (from API??T) 
Call CZI1F1 
Return 

CZAIFl 

Hove ftn interrupt recovery fig (TCHFIE from SCMFIR) 

Reserve TDI space (ISfSEG) 

Disconnect TDY (DISCSEG) and turn off TDY connected flag (ISATDC) 

For taskid 1 only, add system pool devices to TSDL 

using the public volume table (from APIPVT) 
Search the API for users poolid (using TCMPID for compare) 
Move fields from API to SISS?CT JFCB (TDT028 ,.prebuilt) 
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OPEM SYSSVCT fCZCFXS) 

For taskid 1 onl?, ao throuah SYSSfCT and build userid table 

If loin is in progress^ no entry is constructed (UCTJI?) 
Fields referenced or changed inclode (OCT^rON* ^UIBiCIT,. 

llIDCOPYr and the secruepce number UIDNSE-)) 
Field£5 moved include 'ref^erved for maintenance* bit, 

•move user started* bit, P?M limits 
(GETMJilH, SETI B^ GET, construct entry) 
Disconnect userid table (call CZCBM) and then 
FREEHAIN the temporary table space. 
For taskid 1 only, call CZCFW4 to create the dataset 
■systero pool owner .STSCIT2 • 
Call (:ZCFL2 to locate all TBIOCKS vith that dsname beginninq 
If nofi zero return code, FHEF.^AIN all TBLOCKS and continue 
If zero, looD through each TBLOCK and calL CZC3A3 to take 

the DSCB and put it into the uid table (CHBUID) 
ihen done, call CZCFP1 to flush the old SYSCAT, call CZCFW1 
to build a SYSCAT2 for the poolowner, FEFEMAIM the TBIOCKS 
and continue. 
Load address of USERCAT JFCB fTDTCAT, t>rebuilt) and mark 

orivileged access (TDTfPY) and catalog sensitive fTDTRCT) 
DDEF SYSUSE 
DDEF SYS LIB- 
DDEF SYSPLIB 
DDEF SYSHCS 
DDEF SY5;0SE 
DDEF SYSMAC 
DDEF HACNDX 

Call CZCFW1 to build the 'Doolowner .SYSCAT2 . userid dataset' 
If not the oper*/BIO task CTID=1/2) call timer routine (CZA¥B1) 
Call CZATDl 
Return 
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CZATD1 



Open SYSIIB (CZCTJ8) 

FIND SYSKLF member 

If not a bio task (NTCBID=0) and not a conversational task (TCKO?) 

HELFISE the SISI^ JFCB 

DDEF sysin dataset (DCB is C^IHCS) 

turn off conversational flag in 3TC (NTCSW4) 

call CZBTBtt 
If a bio task^ skip rest and return 

If a conversational task^set flag in HTC (NTCSW4) and in PSECT 
XTICT TASKID and put in TCM and NTC 
If operator task 

OPEN SYSOSE (BCB in task common) 

(GET, reset fields, WFITE record back) 

CLOSE SYSOSE 
If abend is creating this task, return (ISIABM) 
TGATRD (Read first sysin record) 
Look for LOGOM 

Check userid for valid characters 
If taskid is 1 call CZIFF2; if not, call CZAFHl 
Set conversational flag in NTC 
Basr to CZBTB1 (L0G0N2) 

If express batch task, call CZCUI to do RCR OPEN for SYSOPEEO 
Then if task is 1 

Call CZICB2 

Turn on task initiated flag (ISATI) 

Turn off logon in progress (ISALP) 

Beturn 
Or if task is a bio task C^TCBIO) (ex. BT,iT) 

Turn on task initiated (ISITI) 

Turn off logon in progress (ISILP) 

Beturn 
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If bio typa task (BIO or NISTtOPKj 

Turn on task initiated flag CISITI) 
Turn off logon in progress (ISALP) 
OBEY 'ZLDGON' 

If abend is creating the task, just return (ISAABF) 
If not, call CZCJQS (QLE to C*A. 5 E.) 
If none of the above (simple conv • task) 

If not a pristine logon (MTCTSK) and not created b? abend (ISAABN) 

FINDBS for STSMAIL dataset 

If one exists HSLEASE the DDEF and inform user he has mail 
Turn on the task initiated flag (ISATI) 
Turn off the logon in proaress flag fISALP) 
OBEY "ZLOGON* 

If the task is being created by abend (ISAABI) , just return 
If not, call CZCJQS (QLF to C.A. 5 E.) 

CZATD2 

If batch monitor or network task or abend creating 

a ne¥ task, call CZAFH2 
In other cases, call CZAFK4 
If not abend creating a new task, return 
If abend is creating a new task (ISAABf) then 

branch into CZATDI code at BASE to CZBTBI 

CZAFK2 CZAFHl 

Mote : the flow for CZAFM2 consists of only those items listed directly 
below CZAFM2. The flow through CZAFMI consists of all the iteiis in 

CZAFK2 plus those items listed directly under C2AFM1 (all lines with an 
asterisk) . 

If shutdown in progress (SCH ITI) , abend 

Call CZUFHI to process keywords 

♦If not abended task (ISAABN) or bulkio tyoe 
*(TC?!BIO) or SYSOUT OPEH, PEMPT CZAFHOOO 

Search JFCB chain for SYSUSE JFC3 
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Kark as catalog sensiti¥e, pri¥ileg8d in TDT 

Set. super privileged bit in ISA 

EEDTJM and save in TCMTOS 

Search the APE to find the pool owner's user id 

OPEN SYSU.se 

For express batch job, cret the userid from the logon card 

and SETUP in TS I 
XTPCT and SETOP conv flaa in TSI 

Call CZCIJA (BCF OPEM) if SISOSE is open (TCHFP3) 
Call CZCUA (RCE OPEM) for TSS and poolowner oserid if 

not already done 
If con¥ersational (TCMCOV) 

Call CZCUA R {CPU tile) 

Call CZCUA (COIN time) 
If non-conversational 

Call CZBT8A to DDEF and OPEN SYSOUT 

GATWR-write out LOGOM card 

If not oper/bulkio type task fTCMOP ^TCMBIO) 
PRMPT CZAFHOOO 

Call CZCUA e 

Call CZCO^ type=TASK 

Set non-conv « print flag on (TCMPiT) 
User privilege to TCM 
Set user table updated (TCMABS) 
Update user table entry (WHITE) 
If shutdown in progress (SCKITI) , abend 

♦Process password 
Set logon ok (TCMLOK) 

Process addressing and charge nuiiber parameters 
Set up privilege class of user (TCMPB?) 
Turn off confirmation flag (TCMCOF) 
Set full message indicator (TCMOPT) 
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Process CSECT oacking, aux . , oristine and xivm parameters 

If aon/conversational task and not a special 

task or call to CZIFlf^l, SIP for timer interrupts (TCMTIKE) 
SETUP user priority 
SCHEB 

SETUP authorization 
Kove authorization to ISi 

If osi:irH=o or p 

P»APTBY T (connect TDY) 

Set up for system hash 
MAPTDf U (connect user) 
If pristine option is not 1, DDEF OSE»?LIB 
Get time and date of logon (EBCDTIME) 
Logon time to TI.TOH 
If non/conversational, BS!« to TATMID and 

BSM to lULTlID 
Set up salutation messages 

♦If not abended task^ PRPPT salutation message 
♦WTI message 
♦lUXSET 
If abended task,. WTL and I0XS5T 
leturn 

CZBTBI 

XTiCT taskid 

Set default number in HTC (HTCDNO) 

Set attention indie, character (!l''*CAIC=*5a») 

Call C2B'^:'B2 

Call CZBTBS 

If a conversational task 

Kark dummy SYSIM DCB (SYSIMDCB) as open (DCB03) 

Put SDJIT entry addr for SYSI!f term, in TCM (TCMSIN) 

Appendix J: LOGON Processing Overview 286.7 



TNL GN20-4106 (01 July 80) to GC28-2008-5 

SIP (Set attentions to go to C2;iSBl) 

If RTAM-do SETTCT 
Peturn 

CZBfB2 

If not a pristine loaon-OPBM OSEBIIB (SYSPRB) 

OPEW OSEPLIB (SYSPROI {DCB=CZ JITE3) 
OPEN USEHLIB (SYSMLF) (DCB=CZATJ9) 
FIND OSERLIB (SYSPRO) 

If not foundr CLOSE (CZATE8) 
Reset DCBLHE fields to 256 
FIND USERLIB fSYSMLF) 
If not an express logon-OPEN SYSLIB (SYSPRO) 

FIND SYSLI3 (SYSPEOI 
OPEN SYSIIB(SYSPRD) 
Return 
CZBTB3 

GETHfliN 1 page for input buffer 
Call CZASD2 (STARTVAR) 

If not a Pristine logon and tJSFRLIB (SYSPRO) exists 
FIND 0SERLIB (SYSPRD) 
If not found {rc=20) 

Get addr of DOB for SYS0LIB (CZBTB3) 
SETI B 
If not found (rc=1) 
SEIL B (DCB=CZATE3) 
GET next record 
Call CZBTB9 (proclib scan) 
Validate and process record 
HASH 

Call CZASD3 

Call CZASD4/CZ1SD5 to search chain again or 
to insert current entry 
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On EODAD,. go to CZBTB5 

If found (rc=0) 

Read the dictionary 
Call CZBTEI 
If SYSLIB (SYSPPO) exists 
FIND SYSLIB (SYSPRD) 
SETL B 
Call CZBT5X 
If not a pristine task 
FIND OSEHLIBfSYSPlX) 
If found 

Get address OSERLIB deb (CZBfB8) 
GETMAIH 
Call CZBTBX 
If not pristine logon 
FIND userlibfSYSFCL) 
If found, TEHMPRO AC?ION=R«*. 
If not found, !!CIST,TSRWPFO ICTION=W 
Close SYSLIB deb (CZBTB7) 
Close deb (CZBTBB) 
Return 
If a pristine task or USEHLIB (SYSPFX) not found 
FIND SYSLIB (SYSPRT) 

If not found, issue msg, close debs and exit 
Get addr of syslib deb (CZBTB7) 

Go to GETMAIH^call CZBTBX and then close (CZBTB7, CZBTBB) 
Return 

CZBfB^ 

FINDJFCB for SYSIN ddnaae 

Set sysin sda in fCM (TCMSIM from TDTID1) 

SETOP sysin 

Flag as TSS SYIM/SYSOUT (ilBTSS '^^ 
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OPNDST fcall TAMII to connect) fCZFTFl) 

Set format of recori (TCWGRD to for variable 

and 1 for fixed) 
Return 

CZBTBA 

RELEASE SYSOUT 

DDEF SYSOOT 

FIJIDJFC3 for SfSG0T ddname 

Set SYSOUT sda in TCM fTCKSOT from TDTID1) 

SETUP sysoot 

Flag as TSS SIS IH/3Y SOUT f^IBTSS) 

OPIDST {TAM II connect) (CZFTF1) 

Set record length in tCS • (TCILNG to 132) 

Return 

Durin,g LOGON processiiio several datasets are ddeffed 
and oDened. If any of these ddefs or opens fails ^ the task 
SYSEBFS and-or ftBEHDS. If the user haopens to be SYSOPFPO, 
the system will not ntartuo. 

Design Solution 

For users and SISOP!?R0, a ISERLIE DDFF or OPEH failure will 

result in a message and a oristine LOGOM. In addition, for 

SYSOPFRO or a conyer sational user^ the LOGON processors 

will attempt to open older aeneration datasets where applicable 

and to teaporarilv bjpasf; other failures for SYSOPER0» 

In the SYSOPFRO case „ since »o^* has not been entered^ the 

systeiE operator or system Droarammers can correct and/or 

re™ipl» To aid in problem letermination ^ the messages will 

contain the dataset name^ what problem was found and how 

it was temporarily bypassed • Every effort will be made to 

coiiplete startup. 
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Module Impacts 

CZAAF {VMTI) 

Set up special abend recovery fields in task common for TID 1 
and the pool owners only 
On ABEND on OPE!l of SISSVCT 

TGATWB message, set uo abend recovery again but skip the 

'-he build of the userid table 
DO HOT E0N AFTER FIXING PROBLEM* ^ BE-IPL. 
On ABBND on SETL B or GI-:t OF SYSSfCT dataset 

TGATiR message, setup ABE^D recovery again and branch to the 

BOD AD routine. 
DO HOT RUN AFTER FIXIHG PROBLEM^ BF-IPL- 
On A3END during •copvcat* processing (for system pool) 
TGATWB message, setup ABEND recovery again and 

skip to USEPCAT orocessing. 
DO NOT RUN AFTER FIXI^TG PEOBLEM, PE-IPL, 
Generally^ where a major SYSER would have been issued, if 
the riD is 1 1- or the userid is the pool ovner, these 
have been converted to linors and co-ie added to 
continue the LOGON process 
added to continue the LOGON process. 
In addition r non-^zero return codes from DDEF are orocessed as 
For SYSLIB(O) - Issue messaae via TGATWH 

Try to DDEF SYSLIB(-I), if successful, 
con tin Lie 

If not, ABEND 2 if t.he TID is 
not 1 or the pool ovner; if TID is 
1 or the pool owner issue minor 
SYSER 1^2,5,1,51,02 and continue 
For SfSUSE - Issue messaqe via TGATMH 

Abend unless TID is 1 or pool owner, ^.hen 
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issue SYSER 1^2,5,1^61,9 and coEtinue 

For SYSKAC/r.ACnDl - Issue message and attenDt to DDSF at the 

1*1) level; If unsuccessful, issue 
SYSE?. 1,2,51,51,10 and continue 
For SYSPLIB - try to DO?.F SYSPLIB (-1) 

If successful put out message 
If unsuccessful continue 
For SISRCS - continue with no roessage 
NOTE: Is the datasets are DDFFFed and/or OPEIed, flags 

indicating the status are set in the logon footprint fields 
in task coimon. They are checked by later modules that 
wish to access or further process those dataset. 

CZITD 

Set UD abend recovery fields in task common for TID 1 

and pool owners only 
If the task comnion footprint indicates that SYSLIB is DDFFed 
On IBEMD on OPEiNI of SYSLIB (SYSRLF) 

Issue a message ¥ia TGATWB , reset ABEND field in task coiiiRon 
and skip the FIMD of SYSLIB fSYSHLF) and continue 
On ABEID on FIND of SYSLIB (SYSMLF) 

Issue a message via TGITWP, reset ABEND field in task common 

•CLOSE* the DCB 

Reset the SYSLIB (SYSKLF) »oDen» flag in footprints 

Set up IBEMD fields in task coFnon and continue 

CZAFK flOGOI) 

Search for the JFCB for SYSOSS 

If not found and it is supposed to be DDEFed (footprint) 

Issue a minor SYSER (1,20,55,62^11) and ABEND 
If not DDSFed and NOT the operator task or pool owner 

a minor SYSER is issued {as above) and the task is abended* 
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If not DDlPed and the task is the operator task, continue 

Por taskii 1 or oool owners only, set up special abend flaas in 

task coiBBon 
If SfSOSB is supposed to be DDEFed 

On OP?! of Sf SOSl failure (for SfSOPftO or pool owners only) 
Set up a du»Bf SfSOSE entry in CEIFis PSECT and continue 
If SfSOSE is not opent skio all iCR processing 
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IBBm. 



Skere aore tkaE one page reference is 
gi¥eB^ the major reference is first. Ill 
references are within plus or minus one of 
the indicated page nu»ber» 

i>races 102 
[ 'l brackets 102 

ellipsis 1 Q2 



itsEJlB interlocks, releasing 55 
absaiate expression (in operand) 102 
dccess met hod ^ terminal 63 
access to syst«i data sets 58 
accessing storage 

PSi/protection key relationships 12 
accouating 

bj charge number ftl 

on a project basis 41 

for shared data sets 39 

by taskid 40 

by us arid 40 
accounting facilities 

(see resource control facilities) 
accounting routines 

install at ion- provided 40 
accounting statistics 41 
active list 47 
active user list, table 42 
a^d device to task symbolic device 

list 105 
add resource diCCBss entries 178 
add shared virtual storage pages 108 
add virtual storage pages 106 
IBDE? macro instruction CSfC 234) 105 
ADDPG aacro instruction (S?C 250) 106 
ADD POOL command 228 
address constant 5 

?-type (?-"Con) 21,29 

a-type (R-con) 21,29,32 

A-type (adcon) 21 
address translation 7 
addressing list, derining 133 
IDSBIfSfC 212) 78.8,73.3 
ADSPG macro instruction CS¥C 286) 103 
allocation of data sets on drums 78.12 
alternate prefix 7 

apostrophe, in macro instructions ^4,96 
ASCII data sets, printing 77 
assembler constants, adjusting 53,54 
asynchronous entry, setting 193 
ATtOL aacro instruction 109 
attention interruption, poll for 109 
authority codes 1,3,281,282 

facilities by 281 
auxiliary storage page 110 
iOXi-s aacro instruction 110 
AOXSET aacro instruction 110 
available auxiliary remaining count 111 
IfAOl aacro instruction 111 



BLDPOOL command 229 
BL0SVCT command 230.1 
BKSG macro instruction 111 
BPKB macro instruction 112 
BTtUBJL macro instruction 114 
BOIID aacro (HCP) 77 



CILL macro instruction, in type~1 linkage 

29 
calling program, return to 181 
cancel real time interruption 115 
CABCL macro instruction 115 
CC command 230.1 
CCi (Channel command word) 67, 6B 

list entry before lOCIL 155 
CHIICT 42 
CailOL 42-45 

CH&MGE macro instruction {S?C 227) 116,47 
change schedule table entry 116 
character arrangement table 205,206 
character strings (in operand) 102 
ChiOlT 41 
CHAOSB 41 

CEBIHVBA macro instruction 117 
CliGfLOCK: macro instruction 119 
Checksum procedure 57 
CI.ASS6TF command 233 
clear page assignment table 243 
CLOSE macro instruction 

for HSIH 121 
CI.B7L0CK macro instruction 119 
CIISIG macro instruction (S?C 236) 122 
Off f POOL command 234 
comma, as delimiter 100 
commands, system | 

IDDPOOL 228 

BLBPOOL 229 

BLBSfCT 230.1 

CC 230.1 

CLASSGTF 233 

CflTPOOL 234 

DDEF 237 

BllPOOL 237 

BIS? 238 

DSCBS 238.1 

BOMPHES 238.2 

B?¥ 238.3 

FIXCIT 239 

FIXDSCB 239 

FIXVI 240 

GTF 241 

BAPGEM 242.2 

lOfEBSSK 242.3 

MliBSG 242.6 

PATCLB&B 242.7 

PAIFIX 243 

POOL? 247 

PIGTF 247 

PBIIT 248 



286*14 



TNL GN204i{)6 (01 July 80) to CC28^2008"-5 



SBCUEB 253 
SlTHfH 253 
TSICE z54 
TEAC2MD 254 

OSAGE 254*2 

?DWP 25^.2 

VDSP 256 

WAi* 259 
commniiicatioB liEe, closing 122 
connect segmeot to shared p^ige table 122 
coEtrol secticm (CShCT) Eai'-iS 

for aoEresident i^rograas 22 

for res id en t p roq r a a s 13 
control transfer fnee linkaie) 
COPI instrcictioii r i sertdo-o|i.iratioii 2D 
core allocation IS 
core release 17 
create load list ei^try 157 
create task scat as xntiex 123,193 
CRSTI aacro inst ructioE (SfC 2S3| 123 
CSS6 aacro instr uct.iott 123 
C¥T macro iRstnictioii 12^4 
CZAijA faccouEtiaq aaduie id) tl4 



DAT 7 

data ckaaael liey 11 

data control block 

preparatxon for proce::.sing 166,167 

referring to user»s 911 

(see also M5AK BCH llxelas and 0CB) 
data set 

allocation on drijiis 78.12 

definiBg 12^ 

ead procesf^ing of Fll 
1 reco¥er y ^ 6 « 3 

DCB aacro instruct ioii 

for SSI I! 12% 
0CE 67 

BCLASS aacro instnictioa '^^29 
DBEF com&aBd 23 7 

DDBF (HSAM) Macro lastru^ctj or* 129 
deadliBe dispatciier 47-48 
debugging aids 284 
deliae a data set 

DDE f coma a a d 2 i 7 
defiDe a polling lii^t "Lis 
DELET aacro inct ruction (Si^C 123) 130 
f delete resource acceso enti-ies 17,^ 
delete task statas index ''34 
delete lirt'aal storage pagt'.s 130 
DSLPG aacro iii.^*t r«ictioii"' (S\'C 249) 130 
DILPOOL coaaaiid 2 57 
DEQG^E aacro ins tract io'ti 1J1 
device, reaoval iroit de¥ict? list 184 
de¥ice soppressioB tlag, r^'set 179 
dial iii operation (JCPI 7d * 2 
direct access storage 2 76 --277 
DISS ^\L macro iBst ruction 132 
di.>.-jliD.g interruptions 2Ct 
disc >njie€rt a mil tiiteraiiidl task 129 
discoDBect share u page table froia 

segment 134 
BISCSEii Mricro instruction 134 
disk storage format 276-2'^7 
DISP coamand 23 S 



dispatc^able list '47^4ti.3 

dispatcher^ deadliiie ^^l-UB 

display nesource isage 21B 

BLIIK aacro insrraction (.SfC 1271 133 

DLTSi ffiacro iEstmctioa fSfC 2^2) 13^* 

drua data set allocation 78=. 12 

drum interlock^ resetting 17 8 

drum storage format 276 

DSCB recovery 56.3 

DSCB slots, validating 5(> 

'3SCBS coHikand 238. 1 

DSKJT 18-19 

DSEG Macro instruction 13h 

DSSEG aacro iastructioii (S¥C 237) 134 

duaay section 1«-19 

duiip, SYSE8 53 

DUMPESS coamand 2 38.2 

30PCLOS1 Eacro iastriictiori 137 

DOI>OPE-J nacro instruction 138 

dYiiasfic account in g m 

dynamic address translation 7 

d|Daiiic loader 271-272 

E'iiCD'rlKE macro in struct! on 50 

elapsed rcsal time ^ reading 179 

eligible list 47^40.3 

EIABLE macro instruction 13t> 

enablina interrup-tioiis 20 

end processino da.ta set 14 1 

E N ''}/ [) EQ IB ec h a n i s n ^0.1 -4 ^ j 

S3QGQY. laacro instruction 137 

<;iiter codes 2t>7|, 136 

eater coanand larquage director to ead 

BOM 189 

;3iiter delete program 130 
CI PEP aacro instruction fi^fC 121) 138 
enter privileged ser¥ice routiae 133 
enter prograa control siibsfsteir, Ij'iS 
entry point riaie^. 13,17 

lor noriresideiit programs 2 1 
mfiCih aacro insmiction (SVC 2541 138^57 

sy Steffi error erodes 139 
error r t?c o v e r j 7 

¥Aa 218 
KS EG macro instruction "i* '4. 1 
event recording 

iiardware 51 

software 51 
/::¥¥ coamaad 233.3^225 
EXC5irj\i aacro insxmctiori 1i^>l 
explicj.T-. address fsee hi addre.ss) 
explicit liaking 133 
explicit ioaiiEg 133 
^JXPMD aacro instr'uctioD 142 
extended coDtroi a ode S 
extended control prog r as status word 

CX?S#i) 6 
extended proqrai. interruption codes 266 
exteiidea tSI lie..a, retting 20? 
external Tiage table entries^ serting ?07,' 
external syaool resolatiou 133 
extract, auxiliary? page cob tents 110' 
extract extended t..ask status index 

field 2?4 
ex 'tract sv'steii table field 223 
ex t r .i crt t a s k st a t u s index f ie i >:^ 2 2 2 

Index 2; 
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;>ii. tie Ids 2 J 
.. >' ■' •-» '* if: ., i cro i ns t c\i ct lo n 1 tt i 

li' ' dj.ruptiori -intry lianclling 79 

...4 /-..'it: (1 ::,.sj, imp ent taDle 2^13 

.* r i'y ■' t im<-^ ^ i i ce en d 212 
'>:i-:LfiCK M'fiCTo i iistmctiofi 143 



siiperifisoE 205 

tasJc iM on it or 285 
iiiterrapuioE routines^ establisliiiig ^S 
interruption storage area (ISA) 10 
mterruptioas 10 

disabliBa 20 

eiidi>liEg 20 

realtime 151 

wditiTig for 1M 
III fOEE macro iasmiction 152 
lOCAL macro ins tract ioa {S¥C 231) 153, i|7 
lO&CB,. format of 155,156 
ISA 10,59 

ITI macro iastruction 156 
If a 9,22 



u-.i-^'i .i I i 2 w ([ t rac e i: a ci i i t y 51-52 

r : : , • :•'. >t t. i or« »i ^-12 ♦■^5:; 1 ^i -~ 1 5 

^ r'V (f s A n } macro iiist met ion 141 

I nt'^rr-afiXion eiitry Handling 79 

(\jKniri coCes l^S 
f ■•:'. .M /.*-f:i)r:i 14 1 
t ;•: '1' A 0ii 1a .h .-^ cro ill .•> true ti on M 5 
-. . : T c u-H ;,', IS 3. c 1 1* !. i I .s t £ 11 c t i o n 146 
'■rJi i.h;:% !iuiK:i:o ill struct ioQ F4B 
: :■: '^ ' t^^ -.i a .% c r o last m c t j.o n 149 
':<'f*-''HK A.-ci. ;> 1,1 i:::triictioii 149 
. J .; *:-a cr:j i iLr-.t ru ct ioE 1 5(1 
»i 'Sy,>':: aacio instruction 152 
:- :i t'jil i ' a a -.: r o { .1 CP ) 1 B 
/rr cor.:^^aiul 2 '41 



■ ■ 1 1 •' 1 w 4 r e » ,• » e f 1 1 r eco r d i ii q 5 1 

• • n> ^ ,\ (^. c £>:,,' i ri.s tr airciu ii 151 
■"'"'■: f mm:£-o (HCPi 7f5 

■ V it ,;". ': 1 • ij 1 as tLuct :lo n 1 !> 1 

T' . ••' ' / I. ■ ' ■ ■ •/ i «?e a d 1 re s sing 47 
I/D dc*rices,r .ceser¥ing 76 

(:: , -, * ,i I s« > S EC OHS coi aa D.d I 
/'< > ; f J 1 1 i fj me lit , d e s i g a a t i a g 76 
i . ' '» ^') I ; ^.* t. ..i t. i o n s , ^' 4LC .'I i nq 172 
x.6imkiil\sit'3 report fiaa 

rt» set ling 18 

v.-tti /!■:; I9S 
i .!■ p I i. .■ : t] id ',} r *-^s 3 C»s 'r^e B I ad dress ) 

i •;. ; ^ cta i€? II Of! i-eci J ent. -prograa detectcid 

^■ll(Jf 209 

■^ ' \ I J i« » ^v t; a s k j. l t e ri: options 156 

■\ j>- 1 1 i.f, J V 1 ri.wdl .r.tarage (If 1) 9 ,,22 

V ii II K-^ t a a i ;r o i n Mt r net i ons 112-116^91-^2 

tie:;'juiivj 9 1 

Tif-stieq 9 2 
^ 11 s ■'' i: 11 ^: : K .* o B, d d d I" *:^ 3 s i II 'C P S ^ 6 
ijitf--'r locks 14 

i: v:', 1 .i a -. :• II g a t A B3 MD 55 
. ;• i . 1: «•" r t ?i p t r e co r c! i. n g 51 
i r , ?. , .-f ■.- y p r ; Ti fi c o fi t r o 1 b 1 oc ks f o r 

>v-?er; oad/o?eriii aw 110 
I ;\ ". .".• r r hptxon e n t r-y handling 79 
J 111 .-:;, r-iptioa '\ ocf 



kejuord operand 102 



LCOMi {S?C 205) 78.8 

leave privilege subroutlEe 32 

line control^ RJE 183 

USE macro (MCP| 78 

line nmiber restrictions 97,20 

lioe„ reooval fro» use 122 

linkage 

lor fence sitters 35-36 

nonprivileged to conprivileged 27 

aoapri¥ilegea to priTileged 29 

privileged from nonprivileged and 
priYileged 31 

privileged to nonprivileged 32 

privileged to privileged 27 
linkage conventions 

fence sitters 35-36 

nonresident prograas 25 

resident programs 21 

tfpe-1 linkage 27 

t¥pe-"1fl/2 linlcage 27 

type -2 linkage 29 

{see also ENTER macro instruction) 

ty|ie~3 linlcage 32 

{see also RSPl? macro instruction) 

type-^ (restricted) linkage 33 

fsee also IN¥OKEp SfOlB, and IBSUHB) 
LLIST aacro instruction 157 
load list entry 

format of 161 

locating 157 
load virtual program status word 161 
lock byte 15 

control 40 . 1 

setting 196 

requests t|0 .1 

resetting 196 

systeii resource 40.1 
LOCPAG ffiacro instruction 160 
LOG? LOCK nacro instruction 161 
LFDS coaaand 239,228 
LO macro (MCP) 78 
LfPSM aacro instruction (S¥C 25«*) 16;; ^32 



aacro definitions,, restriction 97 
Bacro instructions 

de filling 80 

defining R~tfpe 80--84 
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defining S-type B^-b8 
operand size 93 
packing parameters 90 
register notation 90 
setting sign bit 92 
snb lists 96 
subscripts 9 6 
lacro instructions, systeii 
IDDEf 107 

107 

109 

110 

110 
111 

111 



Il-POL 

kWKBG 

AUXSEl' 

AfAOX 

EfiSG 11?* 

BPKD 113 

BTEOBL 115 

CINCX 116 

CHAIGE 117 

CHDltflEA 118 

OfGfLOCK 119 

CLOSE (KSAE) 121 

CIXfLOCS 122 

CiSEG 122 

CETSI 124 

CSEG 124 

CWT 125 

BCB CKSAM) 126 

DCLASS 130 

0ELET 130 

DELFG 131 

BEQGQE 132 

DISABLE 133 

DISCSEG 134 

DLIEK 134.1 

DLfSI 135 

DSEG 135 

DSSEG 136 

DTOCLOSE 137 

DIIP0PE5I 138 

BMAELE 138.2 

BHQGQE 138.3 

ElTLl 139 

BRBOR 139 

ESEG 141 

MXCSEG 141 

EXPII) 142 

FiaiSH (SSAI!) 142.1 

FKEELOCK 144 

GEf CttSAK) 14S 

GETADDR 146 

GETCO&E 147 

GETLOCK 148 

GETPAG 150 

GBTMOIK 150 

GIC 151 

GPS EG 152 

HOOK 152 

ID 152 

IMVOKE 153 

lOCAL 153 

111 157 

LLIST 158 

LOCPAS 161 



LOGVLOCK 162 
L?PS« 162 
H2PTDI 16 3 
nOVGQT. 163 
EOWIB 164 
«SGWR 164.1 
ilB 167 
OCBB 168 

OPEN (flSAff) 168 
OPEliLOCK 169 
OPilfLOCK 169 
PCS¥C 170 
PGOUl 170 
Ph 172 

PBHSEMl 172.1 
PTl 172.1 
PULSE 172.1 
PUPGE 173 
PUT (MSAM) 175 
OSVC 173 
QGQE 177 
RCALL 178 
BDI 179 
RBCRDSTE 179 
RELCORE 180 
RESET 180 
EESETIH 131 
EESO!!£ 182 
RETRHH 182 
EJELC 184 
pnDF? 185 
SHOfriLD 196 
ROPAGE 187 
RPRKPT 187 
RSBG 188 
USPS? 189 
S3SSHR 189 
ESVSEG 190 
EIRS 190.1 
ETTCTL 19 f 
SAMPLE 192 
SAVES 192.2 
SCHED 193 
SCRTSI 194 
SETAE 194 
SLTCTL 195 
SETIE 196 
SSTLOCK 197 
SETSIS 198 
SSTTIHER 199 
SETTl 200 
SETTU 201 
SETUP 201 
SLTOR 202 
SETVLOCK 208 
SETXP 208-1 
SETXTS 208.2 
SIPEHOOK 209 
STORE 210 
STXTR 211 
SISEE 211 
TSEMD 213 
TSTfLOCR 213 
TilAIT 214 
OFLOW 214 
UPDTUSER 217 
OSAGE 219 
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fSLJ DK 
XTRCl 

ZTRITS 



219 

221 
22 J 
224 

225 
226 



sfstea control blocks 
nttiiber 102 



17 



2idcro libraries 
reajor nodes (IfCP 
ilAPGE^I comma E-i 2 
li iU T D f a aero i ns 
Hk£i»UbA operand 
!*CL 2 19 
Eessacje control 

sen.l to task 
syFtejfl error 
up.iates tor ( 
n i u ur nodes | N CP 
jiowe page table 
FOfGQK iiacro 
i10¥!?liS£P coaaand 
HOVij^ aacro last 

fsee ©ultiple 

n^Al'i [>CB fields 

alternate sou 

KSiiife aacro i 

iMultiple seaueEt 

7^ 

DCB options 
DDE! aacro in 
designating d 
interriiptioii 
symbolic devi 
{See also CLO 
and SEfUH) 
iiiiiitipie process 
Eidlt iprocessing 
ffiuItitemiEal ta 
coDEecting 1 
d is con nee ting 



9B 
) 73. 2, 78.5 
42.2 
tniction 163 

76 

block 219 

(fSSIDE) 219,220 
processor 138 
comaaad) 242 •€ 
) 78.2,78.5 

entries 163 
instruction 162 

242.3 
ruction (SWC 245) 



163 



seg-aential access iietbod) 

125-126 
rces 125 
nstruction 163 
ial access letbod (MS&lf) 

125-128 

strnction 130 

eFices 80 

entry handling 79 

ce address 80 

S£, FIIISH, GMT, OFli, POtr 

or system 7 

7 
sk 
22 
129 



E a a lug coe¥entio 
diiiiMf section 
fields 18 
rirst execmta 
resident prog 
secondary ent 
system contro 
ICF 76-78.10 
ICF macros 77-7 
network control 
HEiMSG command 
new updates for 
IIB Macro instrn 
Honc^iEWtrsationa 
devices for 76 
non privileged pr 
n Oft reside at prog 
detinition 7 
linkage conve 



QS 

s 18,22 

jjle instruction 91 
ra». modules 12 
ry points 17 
1 blocks 17 

8 

program 76 -78 .10 

242.6 

messages 242.6 

ction 1 67 

1 task 4 reserving I/O 

ograas 12,24 
raiis 7,22 

ntions 25-35 



ODJect program nodule 

hexadeciaal text portion 5 
progran module dictionary (PKB) 5 
OCBD Macro instruction 166 

OP EI aacro instruction 
for EBhK 166 
OPEILOCK oacro instruction 168 

operand field 100,102 

keyword operands 102,94 

positional operands 102 

size limitation 93 

use of comma 100 

use of parentkeses 102 

writing positional operands 102 

OPNfLOCK macro instruction 168 

packing paraneters 83 
page assignaent table 

clearing 132 

fixing 133 
oage, barrier 59 
page list entry 155 
page table entries, removing 163 
parentheses, in operand field 102 
PATCLMR coMnand 242.7,228 
PIffIX coiiaand 243 
PCCU macro (SCP) 77 
h:s 61,4 

entry to 170 
PCSVC Iiacro instruction (SfC 125) 169 
permit task interruptions 171 
PGOOT aacro instruction (SVC 242) 169 
PED 5 
poll for pending attention 

interruption 109 
polling list, defining 133 
pools (storage) 56 
POOL? conaand 247 
positional operand 102 
PE macro instruction 172 
prefix guantities 

primary prefix 7 

alternate prefix 7 
prefixed storage area (PSA) 6,7 

addressing 7 

definition 7 
prefixing 7 
prejoined user 56 
prepare DCB 166,167 
present current schedule level 171 
VRESEWt macro instruction 171,47 
PBGTF command 247 
primary prefix 7 
PEIIT command 248 

extended 78.12 
printing ISCII data sets 78.12 
printing options 78.12,202 

format for 78. 12 
privilege bit 

for VPSW 6,12 

for real PSW 12 



z9a 



privilege classes 

creatioE of Eew ones 46 

facilities bf 231 

pre defined cl a ss es ^ 6 

ror privilegea systea prograKflier 2 

for systea Monitor 2 

tor system programiier 2 
privilege class E 16 

how to specitf 12 9 
priirilege, restoration o± 138 
priFxleged prograks 12 

wrxliBq 22 
privileged service routine, entry to 133 
privilaged S¥C 252 
problem bit i,ii real PSi 12 
processing tiEit 7 
progxaa control siibsysteifi fPCS) 61^4 

ectry to 1b9 
prograa iEcermption codes, extendc^d 266 
progran inteixmp tion, supervisor state 6 
prograE mask 6 

prograia module dictionary (PKD) 5 
prograa aodule naaes 

for resident prograas 13 

tor virtual programs 21 
program status lioru 

extended 6 

¥irtiial 10 
proi:ectio!i key 11 
prototype control section fPSECTI 2«4 

address coast aats 2 4 

attributes 2^ 

purpose 13 

provision of hask value 152 
PSI 

fsee prefixed storage areal 
PSECT 24 

PSi protection key 6,12 
PTI macro instruction 171 
F!I aacro (SCP) 78 
public pools (storage) 56 
p-tiblic prograffi 

cleamip 232 

coEstruction ot 23 

recreatioE of 246 
PULSfi iacro instruction 17 '',47 
pulixe sckedule table entry le^vel 171 
purge I/O operat2oEs 172 
POfiGE aacro instructioa (SfC 222} 172 
PUT (HSIE) macro instmctioE 174 

card punch 176 

example 176 

iat ex rapt ion entry haadliiig 79 

priater 17S 

retarE codes 175 



QGQE macro iastruction 176 
I QS¥C macro instruction 178 

a~type aacro instructions 

definition 30-84 

exanple 82 

linkage 82 

fflodiiied £-type 88 

operand forms 80^81 

KCILL aacro instraction 177 
EDI aacro instruction fSfC 201) 178 
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RJH line control 183 
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g 5; 11 rikti & acr o ias tmct io a 188 
2SWSEG a aero instruction 196 

i^Tkn log entry 279 
It Tit S aaciro instrnctioa {SWC 122) 
HTrCTI. macro iBstmctioE 191 
RX address 30 



189 



S-type aacro iiistrucrtioEs 
Gfcf 1 1 n i t i o E 3 4 -9 
h-Lifrm 87 
era a pie 38 
L~fc:*i:» 3d 
linkage B7 
rood i t i e A S - ty pe 3 9 
stand ar;l fore 84 
SAEVisl' ifiacro ins tract ion 190 
^iaIaple statas information 190 
,f>a¥e area 

tor is at of 2tl 5 
^r e p a i. a t x on hj 

led¥e prxvilege routine 32 
t: rt SK a on it or 2 9 
user 27 
reomireaeiits 

type 1 linkage 27 
t¥pe~2 liaKage 29 
type-i ixmkage 32 
(i>ee also STOEii) 
staedarci 26 
S A ¥ i.R m a cr o i n st rti crt. i on 1^1 
iiECIiRE CO aim and 2 S3 
SEfhMli coiimaiid 2.^3 
liCiitlj aiacro iast ruction 192 
I i-Cfj^fliile level 171,140.2 
I .schedule l.-ible 43^40.2 
f schednle table entry 19 2 
I changing 116 

f s cliednlina, F^Q^'/DF.Q iil0.3 
I sche:Uili;ic resources 1 5 ,-^0,3 

{see also resource control facilities! 
SLR1SI aacro instruction (SVC 206) 193 
SBk 

(i:ee symboiic de¥ice address) 
secoiiadrv entrj point 17 
seginfefit, cottiiection to SPT 122 
seaci message to another task 219,220 
i>et cisv'achroaous entry 193 
s€-t e'itry ia TBT 197 
set exteraal page table entries 207 
set iiifflediate report flag 195 
set lock byte 196 
set r-altiiie interval 199,197 
set system table xield 197 
set tiae oi day 19!:^ 
set lip extended task status index 

lieiu 207 
set up task status index field 200 
set ap aait recx>rd device 201 
set n^ier timer 200 

SKTAK ^acro instruction (SWC 210) 193 
S£TC1L aacro iastruction 19^ 
SEI'Ik adcro inst ructioB 195 
Ski'xLOZK ifiacro in stnictioa 196 
SKTSIS «acro instruction {S?C 216) 197 



SBTTllEB aacro instrnctioa 197^ tis 
SBTTE macro instruction, (S¥C 217) 199 

time conversion 51 
SFTTU aacro instruction (SWC 251) 200^51 

tine conversioE 51 
SETOF aacro instruct ion {S?C 235) 200 
SEfUS macro iastructioE 201 

card pmicli 201 

iaterriiption entry liaiidliiig 79 

printer 202 

return codes 203 

SYSOCS 207 

SISURS 207^202 
SETfLOCK macro instruction 20 1> 
SETXF macro instrtictioii (SWC 2^^} 207^^7 
SETXfS macro instraction fSfC 21ti) 207 
shared data set accoanticg ^J 
scared virtual storage page,, adding 108 
sign bit, setting 92 
SIPEHOOK 208 

Sil devices for SCP 76^78.1,73.2 
software event recording 51 
special create task status index 193 
startup 5 

station id flCP) 78 •2 
statistics 

displaying 45 

system status 52-53 
status information p saitpling 190 
STB levels current 171 
storage allocation IS 
storage page key 11 
storage protection 11 

(see also ADDPG and A0SFG) 
storage release 17 
STOfiE macro instruction 209,34 
store register contents 209 
structure r task 8 
STITR oacro instruction 210 
SUBIBEH operand 76 
substring notation 9^ 
supervisor calls (see S¥Cs) 
supervisor control locks ^0«1 
supervisor-detected error 139 
supervisor interruption log 2 £5 
supervisor state bit in XPSM 6 
SVCs 

issued by system aacro instructions 262 

nonprivileged 57,262,3 

privileged 56^,3 
switched S3A devices 76 -2 
symbol (in operand) 102 
syaiiolic device address (SBI) 76^47 

in BDEF command 237 
symbolic device list 

removal of task from 184 

(see also IBBEV, RHDE?^ PURGE, and 
BES2T) 
SYSEH duip 58-6i| 

(see also EHSOl and SI SEE) 
SfSEB aacro instruction {SVC 228) 209 ,,58 
SYSGEM for NCP 77-78.3 
SISHCS data set 78.9,78.1^78.2 
S13GEAPH data set 205^208 
system accounting 

(see resource control iacilities) 
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system acconatiag data sets ^5 
system accoantiag siibroiitiae 43^105 
systea acti¥e user list (DSBCT CHIIOLl 

42-45 
s|steia coEtrol block 17 

def iaition 1 7 

natting coaventioBs 18 
system data sets , accessing 58 
systea enter codes 260 
system facilities^ modifying 60 
systea generation 2 
system macro instmctions 3 

deriaing 80-90 

restrictions in usage 3 

{see also aacro instructions ^ systea) 
system aaintenaEce 2 
systea aasJc fin PSl) 9 
systes monitor facilities 4^76 
systea naaes (SfSxxx} 22 
system prograaner 

amtkority code 1 

convent ions for 13 

facilities 2 
coaaaads 3 
aacro instructions 3 
privilege class 2 
responsibilities 2 
i system resource 40 «1 
systea table field 

extracting a field 223 

setting 197 
systen time 

reading SO 

reset 189 
systea user limit table fBSBCT CHIOIT) 
systea user table fDSECT CHIlOSE) 41 
SISTOD 49 
SISOCS 205-208 
SlSULf 41 
SISUBLS, for asiM 207^202 

initial settings 279 
S1SIJS2 41 
S1SJE3 49 



TAMII 63 

task aocoanting 44 

task accounting table 42 

task dictionary fTDI) 271 

task interruption mask 9 

task interruptions 9 

inkibiting 156 

permitting 171 
task aask 9 

task aonitor interruption log 285 
task status index (TSI) 

altering 200 

creation of 123,193 

deletion of 134 

extract a field froa 222 

^tting estimated task tiae 207 

TiAIT flag 2 12 
task strmcture 8 
task symbolic device list fTSBI-) 

fsee IDBEf, SMDEV^ POSGE, IISBT) 
task time maintenance 49 
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TCS 110 

ThT 197 

fDI 271 

temiiial access aetkod 6 3 

terminal cofflnnnication snbprocessor 108 

terminal device table, set entry in 197 

terminal I/O interruption, wait 

for 212^221 
text fin operand) 102 
tiie c:ells 48-51 

ITITIEE 49 

SISfOD 49 

ITSATI 49 

XTSCTI 49 

XfSETI 49 

(see also SETXtS) 

XTSLTS 49 

XTSQi'I 49 
time conversion 51 
tiae of day, setting 199 
time Ekaring support systea C*i-'SSS) 61,4 
time slice end, forcing 212 
time slice end processor 48 
timekeeping facilities 48-49 

operation of 48 

setting an interval tiaer 48 

tiae cells 4 6-49 

tiae conversion routine 51 

types of ti»e maintained 4 8 

use of aacr» instructions 49-50 
tiaer interrupts 191 
trace facility 51-52 
fBICE coaaand 254 
fllCElD conmand 254 

transfer of control (see also linkage} 152 
transfer to dynaaic loader for external 

symbol resolution 133 
1*SDL 

(see IDDE?, RMOB?, FUIGE, and RESET) 
fSElB aacro instruction {S¥C 243) 212,50 
fSI 

(see task status index) 
TSS***** 3 
TSSS 61,4 

fSTVLOCK macro instruction 212 
flllT aacro instruction (SfC 229) 212 
type-1 linkage 27 
type -11/2 linkage 31 
type~2 linkage 29 
type~3 linkage 32 
tj^B-^ (restricted) linkage 3 3 



OFLOl aacro instruction 213 
unit record device set up 20 2 
update user table 

command 254 . 1 

macro instruction 216 
updates for nessages (coMiand) 242.6 
PFDTUSll coaaand 254.1 
OPDTCSEE aacro instruction 216 
OSAGE coBMand 254.2 
OSIGE macro instruction 218,41 
HSBLOCK nacro instruction 218 
user, pre joined 56 



Index 29 J 
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(;5ee virttial provjra® statn.K word) 
rss-'Jr/H is-icro iB-str'^ictioa 220 
¥TSS 69 












wait lor an iatetruptioE 112 

HI. IT siacro iist ruction fSfC 204) 221 

« a i t f o r t e r u i n a 1 I/O ia t er rii p> t i o a 212 



nstmcticii {SfC 246| 222 
ill St. met ion 223 
iastructioR (SfC 215) 223 
instr action (wwc 2131 22^-1,50 
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macro 
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macro 
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ITSITS 
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(set 
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SEROSS'l 


' a aero 



SStXTS aad task status iaJex| 



lEstruction {S?C 194) 225 
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